Annotations

VB C#

using IronPdf;

// Create a new PDF or load and edit an existing document.
var pdf = PdfDocument.FromFile("existing.pdf");

int pageIndex1 = 0;
int pageIndex2 = 1;

// Create a PDF annotation object on a specified page index
var annotation1 = new IronPdf.Annotations.TextAnnotation(pageIndex1)
{
    Title = "This is the major title 1",
    Contents = "This is the long 'sticky note' comment 1st content...",
    X = 150,
    Y = 200,
    Width = 200,
    Height = 50,
    Opacity = 0.9,
    Printable = false,
    Hidden = false,
    OpenByDefault = true,
    ReadOnly = false,
    Rotatable = true
};

var annotation2 = new IronPdf.Annotations.TextAnnotation(pageIndex2)
{
    Title = "This is the major title 2",
    Contents = "This is the long 'sticky note' comment 2nd content...",
    X = 100,
    Y = 150,
    Width = 250,
    Height = 150,
    Opacity = 0.9,
    Printable = false,
    Hidden = false,
    OpenByDefault = true,
    ReadOnly = false,
    Rotatable = true
};

var annotation3 = new IronPdf.Annotations.TextAnnotation(pageIndex2)
{
    Title = "This is the major title 3",
    Contents = "This is the long 'sticky note' comment 3rd content...",
    X = 200,
    Y = 150,
    Width = 150,
    Height = 50,
    Opacity = 0.9,
    Printable = false,
    Hidden = false,
    OpenByDefault = true,
    ReadOnly = false,
    Rotatable = true
};

// Add the annotation "sticky note" within any new or existing PDF.
pdf.Annotations.Add(annotation1); // annotation1 index is 0.
pdf.Annotations.Add(annotation2); // annotation2 index is 1.
pdf.Annotations.Add(annotation3); // annotation3 index is 2.

// Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1); // annotation2 is removed, annotation3 index becomes 1.

// Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0); // remove all annotaion on page 1, annotation3 index becomes 0.

// Edit a single annotation with specified index
pdf.Annotations[0].Title = "new title for annotation 3";
pdf.Annotations[0].Contents = "This is new comment content of annotation 3";

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

pdf.SaveAs("existing.pdf");

Imports IronPdf

' Create a new PDF or load and edit an existing document.
Private pdf = PdfDocument.FromFile("existing.pdf")

Private pageIndex1 As Integer = 0
Private pageIndex2 As Integer = 1

' Create a PDF annotation object on a specified page index
Private annotation1 = New IronPdf.Annotations.TextAnnotation(pageIndex1) With {
	.Title = "This is the major title 1",
	.Contents = "This is the long 'sticky note' comment 1st content...",
	.X = 150,
	.Y = 200,
	.Width = 200,
	.Height = 50,
	.Opacity = 0.9,
	.Printable = False,
	.Hidden = False,
	.OpenByDefault = True,
	.ReadOnly = False,
	.Rotatable = True
}

Private annotation2 = New IronPdf.Annotations.TextAnnotation(pageIndex2) With {
	.Title = "This is the major title 2",
	.Contents = "This is the long 'sticky note' comment 2nd content...",
	.X = 100,
	.Y = 150,
	.Width = 250,
	.Height = 150,
	.Opacity = 0.9,
	.Printable = False,
	.Hidden = False,
	.OpenByDefault = True,
	.ReadOnly = False,
	.Rotatable = True
}

Private annotation3 = New IronPdf.Annotations.TextAnnotation(pageIndex2) With {
	.Title = "This is the major title 3",
	.Contents = "This is the long 'sticky note' comment 3rd content...",
	.X = 200,
	.Y = 150,
	.Width = 150,
	.Height = 50,
	.Opacity = 0.9,
	.Printable = False,
	.Hidden = False,
	.OpenByDefault = True,
	.ReadOnly = False,
	.Rotatable = True
}

' Add the annotation "sticky note" within any new or existing PDF.
pdf.Annotations.Add(annotation1) ' annotation1 index is 0.
pdf.Annotations.Add(annotation2) ' annotation2 index is 1.
pdf.Annotations.Add(annotation3) ' annotation3 index is 2.

' Remove a single annotation with specified index
pdf.Annotations.RemoveAt(1) ' annotation2 is removed, annotation3 index becomes 1.

' Remove all annotaions on a specified page
pdf.Annotations.RemoveAllAnnotationsForPage(0) ' remove all annotaion on page 1, annotation3 index becomes 0.

' Edit a single annotation with specified index
pdf.Annotations(0).Title = "new title for annotation 3"
pdf.Annotations(0).Contents = "This is new comment content of annotation 3"

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

pdf.SaveAs("existing.pdf")

Install-Package IronPdf

Annotations

Your business is spending too much on yearly subscriptions for PDF security and compliance. Consider IronSecureDoc, which provides solutions for managing SaaS services like digital signing, redaction, encryption, and protection, all for one-time payment. Explore IronSecureDoc Documentation

PDF annotations allow "sticky note"-like comments to be added to PDF pages. The IronPDF.PdfDocument.AddTextAnnotation method and PdfDocument.TextAnnotation class allow annotations to be added programmatically. Advanced text annotation features supported include coloring, sizing, opacity, icons, and editing.

How to Add PDF Annotation in .NET

Install C# library to add annotation to PDF.
Open an existing or generate a new PDF in .NET.
Create a TextAnnotation class and customize properties.
Utilize the AddTextAnnotation method to add the newly created annotation to the PDF.
Export the modified PDF to the desired folder.

// This example demonstrates how to add a text annotation to a PDF using IronPDF in C#.
using IronPdf;

class Program
{
    static void Main()
    {
        // Load an existing PDF document
        var pdf = PdfDocument.FromFile("example.pdf");

        // Create a text annotation
        var annotation = new PdfDocument.TextAnnotation
        {
            PageNumber = 1, // Specify the page number to add the annotation
            X = 100, // X coordinate on the page
            Y = 150, // Y coordinate on the page
            Text = "This is a sample annotation.", // Content of the annotation
            Color = "Yellow", // Background color of the annotation
            Icon = AnnotationIcon.Comment, // Icon style for the annotation
            Opacity = 0.8 // Opacity of the annotation
        };

        // Add the annotation to the PDF
        pdf.AddTextAnnotation(annotation);

        // Save the modified PDF to a file
        pdf.SaveAs("modified_example.pdf");
    }
}

// This example demonstrates how to add a text annotation to a PDF using IronPDF in C#.
using IronPdf;

class Program
{
    static void Main()
    {
        // Load an existing PDF document
        var pdf = PdfDocument.FromFile("example.pdf");

        // Create a text annotation
        var annotation = new PdfDocument.TextAnnotation
        {
            PageNumber = 1, // Specify the page number to add the annotation
            X = 100, // X coordinate on the page
            Y = 150, // Y coordinate on the page
            Text = "This is a sample annotation.", // Content of the annotation
            Color = "Yellow", // Background color of the annotation
            Icon = AnnotationIcon.Comment, // Icon style for the annotation
            Opacity = 0.8 // Opacity of the annotation
        };

        // Add the annotation to the PDF
        pdf.AddTextAnnotation(annotation);

        // Save the modified PDF to a file
        pdf.SaveAs("modified_example.pdf");
    }
}

' This example demonstrates how to add a text annotation to a PDF using IronPDF in C#.
Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Load an existing PDF document
		Dim pdf = PdfDocument.FromFile("example.pdf")

		' Create a text annotation
		Dim annotation = New PdfDocument.TextAnnotation With {
			.PageNumber = 1,
			.X = 100,
			.Y = 150,
			.Text = "This is a sample annotation.",
			.Color = "Yellow",
			.Icon = AnnotationIcon.Comment,
			.Opacity = 0.8
		}

		' Add the annotation to the PDF
		pdf.AddTextAnnotation(annotation)

		' Save the modified PDF to a file
		pdf.SaveAs("modified_example.pdf")
	End Sub
End Class

$vbLabelText $csharpLabel

View on GitHub

Code

https://github.com/iron-software/IronPdf.Examples/tree/main/examples/annotations

Download ZIP