> For the complete documentation index, see [llms.txt](https://docs.apryse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apryse.com/android/annotation/delete-annot.md).

# Deleting annotations in Android

Learn how to efficiently delete annotations in PDF documents using the Apryse library. Easily delete single or all annotations on a page or in a document. Keep track of page numbers for quick deletion

Using the Apryse library, you can delete a single annotation, delete all the annotations on a page, or delete all the annotations in a PDF document.

{% hint style="info" %}
The Apryse library has an annotation list dialog fragment. The dialog fragment allows users to delete annotations easily. For more information, see [annotation dialog fragment ](/android/annotation/annotation-list-a.md).
{% endhint %}

{% hint style="warning" %}
To delete an annotation, you need the page number of the annotation. To avoid looping through the whole document to find the page number of the annotation, we recommend you always keep track of the page number when you get an annotation.
{% endhint %}

## Delete an annotation

{% hint style="info" %}
To delete an annotation, you need to lock `PDFViewCtrl` first. See the section on [document locking](/android/open-save-document/lock.md) for more information.
{% endhint %}

You can delete an annotation as follows:

{% tabs %}
{% tab title="Java" %}
{% code lineNumbers="true" %}

```java
public void deleteAnnotation(final PDFViewCtrl pdfViewCtrl, final Annot annot, final int pageNum) throws Exception {
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true, new PDFViewCtrl.LockRunnable() {
        @Override
        public void run() throws Exception {
            Page page = pdfViewCtrl.getDoc().getPage(pageNum);
            page.annotRemove(annot);
            pdfViewCtrl.update(annot, pageNum);
        }
    });
}
```

{% endcode %}
{% endtab %}

{% tab title="Kotlin" %}
{% code lineNumbers="true" %}

```kotlin
fun deleteAnnotation(pdfViewCtrl: PDFViewCtrl, annot: Annot?, pageNum: Int) { 
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true) {
        val page = pdfViewCtrl.doc.getPage(pageNum)
        page.annotRemove(annot)
        pdfViewCtrl.update(annot, pageNum)
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Delete all annotations on a page

The following snippet shows how to enumerate all the annotations on a page, as well as how to delete them.

{% tabs %}
{% tab title="Java" %}
{% code lineNumbers="true" %}

```java
void deleteAnnotationsOnPage(final PDFViewCtrl pdfViewCtrl, final int pageNum) throws Exception {
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true, new PDFViewCtrl.LockRunnable() {
        @Override
        public void run() throws Exception {
            Page page = pdfViewCtrl.getDoc().getPage(pageNum);
            int annotCount = page.getNumAnnots();
            while (annotCount > 0) {
                page.annotRemove(0);
                annotCount = page.getNumAnnots();
            }
            pdfViewCtrl.update(true);
        }
    });
}
```

{% endcode %}
{% endtab %}

{% tab title="Kotlin" %}
{% code lineNumbers="true" %}

```kotlin
fun deleteAnnotationsOnPage(pdfViewCtrl: PDFViewCtrl, pageNum: Int) {
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true) {
        val page = pdfViewCtrl.doc.getPage(pageNum)
        var annotCount = page.numAnnots
        while (annotCount > 0) {
            page.annotRemove(0)
            annotCount = page.numAnnots
        }
        pdfViewCtrl.update(true)
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Delete all the annotations in a PDF document

The following snippet shows how to traverse all the pages in a PDF document and delete all the annotations.

{% tabs %}
{% tab title="Java" %}
{% code lineNumbers="true" %}

```java
void deleteAllAnnotations(final PDFViewCtrl pdfViewCtrl) throws Exception {
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true, new PDFViewCtrl.LockRunnable() {
        @Override
        public void run() throws Exception {
            PDFDoc pdfDoc = pdfViewCtrl.getDoc();
            PageIterator itr = pdfDoc.getPageIterator();
            while (itr.hasNext()) {
                Page page = (Page) itr.next();
                int annotCount = page.getNumAnnots();
                while (annotCount > 0) {
                    page.annotRemove(0);
                    annotCount = page.getNumAnnots();
                }
            }
            pdfViewCtrl.update(true);
        }
    });
}
```

{% endcode %}
{% endtab %}

{% tab title="Kotlin" %}
{% code lineNumbers="true" %}

```kotlin
fun deleteAllAnnotations(pdfViewCtrl: PDFViewCtrl) { 
    // Lock the document first, because accessing annotation/doc information isn't thread-safe.
    pdfViewCtrl.docLock(true) {
        val pdfDoc = pdfViewCtrl.doc
        val itr = pdfDoc.pageIterator
        while (itr.hasNext()) {
            val page = itr.next()
            var annotCount = page!!.numAnnots
            while (annotCount > 0) {
                page.annotRemove(0)
                annotCount = page.numAnnots
            }
        }
        pdfViewCtrl.update(true)
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.apryse.com/android/annotation/delete-annot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.