Extract Annotations from Microsoft Office Word documents Leave feedback

Microsoft Office Word documents (.doc, .docx) often contain annotations – comments, tracked changes, or embedded notes left by reviewers. With GroupDocs.Parser for .NET, you can easily read these annotations programmatically using the GetAnnotations method.

Annotations are comments, tracked changes, or other embedded notes that reviewers attach to a Word (.doc, .docx) document during a review pass. The GetAnnotations method reads this markup and returns it as a collection of AnnotationItem objects, each exposing a Value with the annotation’s text, along with metadata such as the author and timestamp.

The method has two overloads:

Follow these steps to get annotations from a .doc or .docx file:

1. Create a Parser object and load the Word document.
2. Call the GetAnnotations method to retrieve the annotation collection.
3. Iterate through the collection and read each annotation’s value.

using (Parser parser = new Parser(@"MyDocument.docx"))
{
    // Extract annotations
    IEnumerable<AnnotationItem> annotations = parser.GetAnnotations();

    // Display annotations
    foreach (AnnotationItem item in annotations)
    {
        Console.WriteLine(item.Value);
    }
}

Warning

GetAnnotations method returns null if annotation extraction isn’t supported for the document. If the Word document has no comments, GetAnnotations method returns an empty collection.

Sometimes it’s useful to get the document’s text and its comments in one pass, instead of calling GetAnnotations separately. Set IncludeAnnotations to true on TextOptions and pass it to the GetText method – the annotation text will be included in the extracted output alongside the regular document text.

using (Parser parser = new Parser(@"MyDocument.docx"))
{
    TextOptions options = new TextOptions
    {
        IncludeAnnotations = true
    };

    using (TextReader reader = parser.GetText(options))
    {
        string text = reader.ReadToEnd();
        Console.WriteLine(text);
    }
}

Each AnnotationItem also exposes metadata that helps trace who left a comment in a document and when:

using (Parser parser = new Parser(@"MyDocument.docx"))
{
    IEnumerable<AnnotationItem> annotations = parser.GetAnnotations();

    foreach (AnnotationItem annotation in annotations)
    {
        Console.WriteLine($"Page: {annotation.PageIndex}, Author: {annotation.AuthorName} ({annotation.AuthorInitials})");
        Console.WriteLine($"Created/Modified: {annotation.Timestamp}, Type: {annotation.AnnotationType}");
        Console.WriteLine($"Comment: {annotation.Value}");
    }
}

Extracting comments from Microsoft Office Word documents is useful for:

• Review workflows – collect reviewer feedback left in documents during a review cycle.
• Collaboration – surface document comments without opening Word.
• Auditing – track who commented on a document, and when, over time.

You may easily run the code above and see the feature in action in our GitHub examples:

• GroupDocs.Parser for .NET examples
• GroupDocs.Parser for Java examples

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to parse documents and extract data from PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX, Emails and more with our free online Free Online Document Parser App.