How to Add and Edit PDF Annotations in C#

What Properties Can I Set for Text Annotations?

The TextAnnotation class provides several properties for customization beyond the basic ones:

• Title: The annotation's header text, typically displayed in the annotation popup
• Contents: The main body text of the annotation
• X, Y: The coordinates specifying where the annotation icon appears on the page
• PageIndex: The zero-based page number where the annotation should be placed
• Subject: An optional subject line for categorizing annotations
• Icon: The visual representation of the annotation (e.g., Note, Comment, Help)
• Open: Whether the annotation popup is open by default

These properties enable developers to create rich, contextual annotations that enhance document communication. For advanced workflows involving multiple document types, consider exploring RTF to PDF conversion or Markdown to PDF conversion to maintain annotations across different source formats.

How Do Coordinates Work in PDF Annotations?

Why Would I Need to Edit Existing Annotations?

Editing annotations becomes essential in collaborative document workflows where feedback needs updating based on revisions, clarifications are required for ambiguous comments, or annotations need repositioning due to content changes. This capability ensures that document reviews remain current and relevant throughout the revision cycle.

In enterprise environments, annotation editing often integrates with approval workflows where supervisors may need to modify reviewer comments before final approval. Additionally, when documents undergo translation or localization, annotations may require updates to reflect language changes or cultural adaptations. For such scenarios, IronPDF's UTF-8 and international language support ensures annotations display correctly across different languages and character sets.

What Happens to Other Document Properties When Editing Annotations?

The editing process maintains all other document properties and content, ensuring that only the specified annotation is modified. Document structure, formatting, embedded resources, and other annotations remain unchanged, preserving the integrity of your PDF while allowing targeted updates to specific review comments.

This selective editing approach is crucial for maintaining document integrity, especially in regulated industries where document tampering must be avoided. The process preserves digital signatures, form fields, bookmarks, and all other PDF features. For documents requiring audit trails, consider implementing revision history tracking alongside annotation modifications.

PDF with an Edited Annotation

The annotation in the PDF document above can be viewed with the Chrome browser.

---

My favorite library of this kind is IronPDF. It allows for fast and efficient manipulation of PDF files. It also has many valuable features, like exporting to PDF/A format and digitally signing PDF documents.

Milan Jovanovic

Microsoft MVP

View case study

IronOCR means we can save $40,000 annually from manual processing, while enhancing productivity and freeing up resources for high-impact tasks. I would highly recommend it.

Brent Matzelle

Chief Technology Officer, OPYN

View case study

The IronSuite play a crucial role in our operations. These are tools that increase efficiencies across the business including creating floor plans and improving inventory management.

David Jones

Lead Software Engineer, Agorus Build

View case study

How Can I Remove a Single Annotation?

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-single-annotation.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1);

pdf.SaveAs("removeSingleAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1)

pdf.SaveAs("removeSingleAnnotation.pdf")

How Can I Remove All Annotations at Once?

To remove all annotations on a particular page, use the RemoveAllAnnotationsForPage method and specify the page index. If you want to remove all annotations in the entire document, call the Clear method on the Annotations property.

This bulk removal capability is particularly useful when preparing documents for final distribution or when implementing document versioning systems where annotations from previous review cycles need to be removed. Consider combining this with metadata editing to update document properties and indicate the review status. For workflows requiring sanitized documents, explore [PDF sanitization](https://ironpdf.com/how to sanitize-pdf/) options to remove all potentially sensitive information including annotations.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-remove-all-annotation.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("multipleAnnotation.pdf");

// Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0);

// Remove all annotaions on the document
pdf.Annotations.Clear();

pdf.SaveAs("removeAllAnnotation.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("multipleAnnotation.pdf")

' Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0)

' Remove all annotaions on the document
pdf.Annotations.Clear()

pdf.SaveAs("removeAllAnnotation.pdf")

When Should I Use Bulk Annotation Removal?

Bulk removal is ideal when finalizing documents for distribution, creating clean versions for archival purposes, or implementing document versioning where annotations from previous review cycles must be cleared. This approach saves time compared to removing annotations individually and ensures no review comments accidentally remain in production documents.

Additionally, bulk removal is essential when preparing documents for automated processing systems that may not handle annotations correctly, or when converting annotated PDFs to other formats. For high-security environments, removing all annotations before distribution prevents inadvertent disclosure of internal review comments or sensitive feedback that wasn't intended for external audiences.

What Is the Difference Between a Link Annotation and a Text Annotation?

A TextAnnotation is a "sticky note": a comment icon that displays text when clicked. A LinkAnnotation is a navigation control, an invisible or bordered clickable region that jumps the reader to a target page. Both share the Annotations collection and the same Add, RemoveAt, RemoveAllAnnotationsForPage, and Clear operations, so you can mix comments and navigation links in the same document and manage them together.

Because LinkAnnotation targets pages in the same file, it complements IronPDF's outlines and bookmarks (which build the viewer's sidebar navigation tree) and the auto-generated table of contents feature for HTML-to-PDF rendering. Use bookmarks for the sidebar, the TOC feature for rendered HTML, and LinkAnnotation when you need clickable hotspots on an existing PDF.

How Do I Control What the Reader Sees at the Destination?

The DestinationType property uses the existing BookmarkDestinations enum to control how the target page is displayed when the link is clicked. The default is BookmarkDestinations.Page, which fits the whole destination page in the window. Other values scroll to a position, set a zoom level, or fit a specific rectangle, using the DestinationTop, DestinationLeft, DestinationRight, DestinationBottom, and DestinationZoom coordinates.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-link-destination-types.cs

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;

PdfDocument pdf = PdfDocument.FromFile("multipage.pdf");

// 1. Scroll to a specific vertical position on the destination page (full width shown)
LinkAnnotation scrollLink = new LinkAnnotation(0, 2)
{
    X = 72, Y = 680, Width = 300, Height = 16,
    DestinationType = BookmarkDestinations.PageY,
    DestinationTop = 400        // scroll so y=400 sits at the top of the view
};
pdf.Annotations.Add(scrollLink);

// 2. Jump to a position AND set the zoom level
LinkAnnotation zoomLink = new LinkAnnotation(0, 3, "Zoom to figure")
{
    X = 72, Y = 650, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageZoom,
    DestinationLeft = 100,
    DestinationTop = 500,
    DestinationZoom = 150       // 150% zoom; use 0 to inherit the current zoom
};
pdf.Annotations.Add(zoomLink);

// 3. Fit a specific rectangle on the destination page
LinkAnnotation rectLink = new LinkAnnotation(0, 4)
{
    X = 72, Y = 620, Width = 200, Height = 16,
    DestinationType = BookmarkDestinations.PageRect,
    DestinationLeft = 50,
    DestinationBottom = 100,
    DestinationRight = 550,
    DestinationTop = 700
};
pdf.Annotations.Add(rectLink);

pdf.SaveAs("link-destinations.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks

Dim pdf As PdfDocument = PdfDocument.FromFile("multipage.pdf")

' 1. Scroll to a specific vertical position on the destination page (full width shown)
Dim scrollLink As New LinkAnnotation(0, 2) With {
    .X = 72, .Y = 680, .Width = 300, .Height = 16,
    .DestinationType = BookmarkDestinations.PageY,
    .DestinationTop = 400        ' scroll so y=400 sits at the top of the view
}
pdf.Annotations.Add(scrollLink)

' 2. Jump to a position AND set the zoom level
Dim zoomLink As New LinkAnnotation(0, 3, "Zoom to figure") With {
    .X = 72, .Y = 650, .Width = 200, .Height = 16,
    .DestinationType = BookmarkDestinations.PageZoom,
    .DestinationLeft = 100,
    .DestinationTop = 500,
    .DestinationZoom = 150       ' 150% zoom; use 0 to inherit the current zoom
}
pdf.Annotations.Add(zoomLink)

' 3. Fit a specific rectangle on the destination page
Dim rectLink As New LinkAnnotation(0, 4) With {
    .X = 72, .Y = 620, .Width = 200, .Height = 16,
    .DestinationType = BookmarkDestinations.PageRect,
    .DestinationLeft = 50,
    .DestinationBottom = 100,
    .DestinationRight = 550,
    .DestinationTop = 700
}
pdf.Annotations.Add(rectLink)

pdf.SaveAs("link-destinations.pdf")

How Do I Position a Link Over Existing Text?

To overlay a clickable link on text that already exists on a page, extract the text with PdfPage.TextChunks and use each chunk's BoundingBox to size the link. Because PDF coordinates originate at the bottom-left of the page, assign BoundingBox.Bottom to Y, not BoundingBox.Top, which would place the clickable area above the visible text. Set Hidden = true to drop the visible border so the link sits invisibly over the rendered text.

This is the foundation for turning a static, printed table of contents into a navigable one. The example below scans the TOC page, matches each entry by its text, and overlays an invisible LinkAnnotation that jumps to the right page.

:path=/static-assets/pdf/content-code-examples/how-to/annotation-link-toc.cs

using IronPdf;
using IronPdf.Annotations;
using IronPdf.Bookmarks;
using System;
using System.Collections.Generic;

PdfDocument pdf = PdfDocument.FromFile("report-with-toc.pdf");

// Zero-based index of the page that holds the table-of-contents text
int tocPageIndex = 1;

// Map each TOC entry's leading text to the page index it should jump to
var tocEntries = new Dictionary<string, int>
{
    { "Introduction", 2 },
    { "Methodology",  4 },
    { "Results",      6 },
    { "Conclusion",   9 },
};

// Walk the text chunks on the TOC page and overlay a clickable link on each match
foreach (var chunk in pdf.Pages[tocPageIndex].TextChunks)
{
    string text = chunk.Contents.Trim();

    foreach (var entry in tocEntries)
    {
        if (!text.StartsWith(entry.Key)) continue;

        var box = chunk.BoundingBox;
        pdf.Annotations.Add(new LinkAnnotation(tocPageIndex, entry.Value)
        {
            X = (int)box.Left,
            Y = (int)box.Bottom,                       // Bottom, NOT Top (PDF origin is bottom-left)
            Width = (int)Math.Max(box.Width, 400),
            Height = (int)Math.Abs(box.Top - box.Bottom),
            DestinationType = BookmarkDestinations.PageY,
            DestinationTop = 792,                      // top of a US Letter page
            Hidden = true                              // invisible overlay on the existing TOC text
        });
        break;
    }
}

pdf.SaveAs("clickable-toc.pdf");

Imports IronPdf
Imports IronPdf.Annotations
Imports IronPdf.Bookmarks
Imports System
Imports System.Collections.Generic

Dim pdf As PdfDocument = PdfDocument.FromFile("report-with-toc.pdf")

' Zero-based index of the page that holds the table-of-contents text
Dim tocPageIndex As Integer = 1

' Map each TOC entry's leading text to the page index it should jump to
Dim tocEntries As New Dictionary(Of String, Integer) From {
    {"Introduction", 2},
    {"Methodology", 4},
    {"Results", 6},
    {"Conclusion", 9}
}

' Walk the text chunks on the TOC page and overlay a clickable link on each match
For Each chunk In pdf.Pages(tocPageIndex).TextChunks
    Dim text As String = chunk.Contents.Trim()

    For Each entry In tocEntries
        If Not text.StartsWith(entry.Key) Then Continue For

        Dim box = chunk.BoundingBox
        pdf.Annotations.Add(New LinkAnnotation(tocPageIndex, entry.Value) With {
            .X = CInt(box.Left),
            .Y = CInt(box.Bottom),                       ' Bottom, NOT Top (PDF origin is bottom-left)
            .Width = CInt(Math.Max(box.Width, 400)),
            .Height = CInt(Math.Abs(box.Top - box.Bottom)),
            .DestinationType = BookmarkDestinations.PageY,
            .DestinationTop = 792,                      ' top of a US Letter page
            .Hidden = True                              ' invisible overlay on the existing TOC text
        })
        Exit For
    Next
Next

pdf.SaveAs("clickable-toc.pdf")

Can I Create Back-to-Top or Same-Page Links?

Yes. Same-page links, where pageIndex equals destinationPageIndex, are fully supported and are the typical way to build a "back to top" button. Combine a same-page link with DestinationType = BookmarkDestinations.PageY and a high DestinationTop value so the click scrolls the reader to the top of the current page. Add the same link to the foot of every page to give long reports a consistent return-to-top control.

Why Do Coordinate Systems Matter for Annotations?

PDF coordinates originating from the bottom-left corner can cause confusion for developers accustomed to top-left origin systems. Incorrect coordinate calculations may place annotations in unexpected locations, potentially obscuring important content or appearing off-page. Always convert coordinates appropriately when integrating with UI frameworks or user input systems.

Understanding the coordinate system becomes even more critical when implementing features like click-to-annotate functionality or when converting screen coordinates from user interactions to PDF coordinates. For complex positioning requirements, consider using IronPDF's viewport and zoom capabilities to ensure annotations appear correctly regardless of viewing conditions.

How Can I Optimize Performance When Adding Multiple Annotations?

When adding multiple annotations, batch your operations by adding all annotations to the collection before saving the document. This approach reduces file I/O operations and improves performance significantly, especially with large PDFs or when processing multiple documents in succession. Consider implementing progress indicators for better user experience during bulk operations.

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

// Example of batch annotation processing
var annotations = new List<TextAnnotation>();
for (int i = 0; i < 100; i++)
{
    annotations.Add(new TextAnnotation(0) 
    { 
        Title = $"Note {i}", 
        Contents = $"Content for note {i}",
        X = 50 + (i * 10),
        Y = 700 - (i * 20)
    });
}

// Add all annotations at once
foreach (var annotation in annotations)
{
    pdf.Annotations.Add(annotation);
}

// Save once after all additions
pdf.SaveAs("batch-annotated.pdf");

Imports System.Collections.Generic

' Example of batch annotation processing
Dim annotations As New List(Of TextAnnotation)()
For i As Integer = 0 To 99
    annotations.Add(New TextAnnotation(0) With {
        .Title = $"Note {i}",
        .Contents = $"Content for note {i}",
        .X = 50 + (i * 10),
        .Y = 700 - (i * 20)
    })
Next

' Add all annotations at once
For Each annotation In annotations
    pdf.Annotations.Add(annotation)
Next

' Save once after all additions
pdf.SaveAs("batch-annotated.pdf")

For even better performance in high-volume scenarios, consider using asynchronous processing or multithreading techniques to handle annotation operations in parallel.

What Should I Consider for Cross-Viewer Compatibility?

Different PDF viewers may render annotations with varying icon styles, popup behaviors, or positioning quirks. Always test your annotated PDFs in popular viewers like Adobe Acrobat, Chrome, Edge, and mobile PDF readers to ensure annotations appear correctly and remain functional across platforms your users might employ.

Some viewers may not support all annotation types or may display them differently. For maximum compatibility, stick to standard annotation types and avoid relying on viewer-specific features. When deploying to specific environments like Azure or AWS, test annotations in the target environment's default PDF viewers to ensure consistent behavior.

Ready to see what else you can do? Check out our tutorial page here: Edit PDFs