GroupDocs.Annotation for Python via .NET Leave feedback

Release notes Download from PyPI Online app

GroupDocs.Annotation for Python via .NET is a document annotation API that adds, edits, and removes annotations and markup across many document formats. It provides a unified, format-independent interface to draw area and shape annotations, mark up text with highlights, underlines, strikeouts, and squiggly lines, stamp watermarks, images, and hyperlinks, add editable text fields, and attach threaded review comments — then save the result back to its original format with optional page-range and annotation-type filters.

from groupdocs.annotation import Annotator
from groupdocs.annotation.models import Rectangle
from groupdocs.annotation.models.annotation_models import AreaAnnotation
from groupdocs.pydrawing import Color

# Add an area annotation to the first page of a PDF
with Annotator("input.pdf") as annotator:
    area = AreaAnnotation()
    area.box = Rectangle(100, 100, 200, 80)        # x, y, width, height
    area.page_number = 0                            # 0-based page index
    area.background_color = Color.yellow.to_argb()  # ARGB int, not a Color object
    area.message = "Review this section"
    annotator.add(area)
    annotator.save("annotated.pdf")

• Shape Annotations: Draw area, ellipse, arrow, point, distance, and polyline annotations with configurable color and opacity.
• Text Markup: Highlight, underline, strikeout, and squiggly-mark text, replace or redact text, and redact embedded resources.
• Content Annotations: Stamp watermarks, image annotations, hyperlinks, and editable text fields onto a document.
• Comments & Replies: Attach threaded review comments to any annotation with user and timestamp information.
• Manage Annotations: List, update, and remove annotations — all of them or filtered by annotation type.
• Save Filters: Render only selected annotation types or a specific page range when saving the result.

GroupDocs.Annotation supports a wide range of file formats. For a complete list, see the full list of supported formats.

• Microsoft Office (Word, Excel, PowerPoint)
• PDF
• Images (JPEG, PNG, BMP, TIFF)
• CAD (DWG, DXF)
• Visio Diagrams (VSD, VSDX)
• Email (EML, EMLX)
• OpenDocument (ODT, ODS, ODP)

To get started, refer to the System Requirements, Supported File Formats, Installation, and Hello, World! sections for setup instructions and your first annotation.

For practical, runnable code examples covering basic and advanced annotation, see the Developer Guide section. It walks through loading documents, adding every annotation type, attaching comments and replies, listing and removing annotations, and saving results with page-range and annotation-type filters.

Using an AI coding assistant? The AI Agents & LLM Integration page covers the bundled AGENTS.md reference, the GroupDocs MCP server, and machine-readable documentation.

If you experience any issues or have suggestions, see Technical Support for the available channels — the free support forum and the paid helpdesk. For licensing and evaluation questions, see Licensing and Subscription.