Issue
One of the most common areas of confusion in PDF remediation is understanding the difference between annotations, Annot tags, and other accessibility tags such as Link and Form.
An annotation is an interactive object within the PDF, such as a hyperlink, form field, comment, or highlight. Although annotations appear in the Tags tree with an icon that resembles a tag (often called an OBJR or Object Reference in Adobe Acrobat), they are not tags. Instead, annotations are PDF objects that must be contained within the appropriate structural tag.
Using the wrong tag type can cause PDF/UA validation failures and may prevent assistive technologies from correctly identifying or interacting with the annotation.
Symptom
How do you know if you have a problem:
- A link annotation is contained in an Annot tag instead of a Link tag.
- A form field (widget annotation) is contained in an Annot tag instead of a Form tag.
- A validation tool reports that a link or form annotation is improperly tagged.
- You cannot convert an annotation itself to another tag type in CommonLook PDF.
- Interactive content is missing because the document contains a Link or Form tag but no actual annotation.
Causes
This issue most commonly occurs because of confusion between annotations and tags.
It is important to understand that:
- Annotations are interactive PDF objects.
- Tags provide the document's semantic structure.
- Annotations must be placed inside the appropriate semantic tag.
Affected Users
Improperly tagged annotations primarily affect:
- Screen reader users, who rely on semantic tags to identify links, form fields, and interactive content.
- Keyboard-only users, who depend on correctly tagged interactive controls for navigation.
- Users of other assistive technologies that interpret PDF structure.
Accessibility Guidelines
PDF/UA 1.0 requires interactive annotations to be contained within the appropriate structural element.
Resolution Steps
1. Identify the Annotation Type - Determine what type of annotation is present.
2. Place the Annotation in the Correct Tag -Move the annotation into the proper structural tag.
| Annotation Type | Correct Structural Tag |
|---|---|
| Hyperlink | Link |
| Form field (widget) | Form |
| Internal document reference | Reference containing a Link tag |
| Highlight annotation | Annot |
| Popup comment | Annot |
| Sticky note/comment | Annot |
| File attachment | Annot |
| Audio or multimedia annotation | Annot |
Verification
The issue has been resolved when:
- Every annotation is contained within the appropriate structural tag.
- Link annotations are contained within Link tags.
- Widget annotations are contained within Form tags.
- Internal references use Reference tags with nested Link tags when clickable.
- Highlights, comments, and other miscellaneous annotations are contained within Annot tags.
- No annotation remains improperly tagged or untagged.
- PDF/UA validation completes without annotation-related failures.
Related Articles
How to Create Properly Tagged Links (Desktop and Advanced Editor)
What is a Properly Tagged Form (Desktop and Advanced Editor)
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article