How to Fix Missing Alternative Text for PDF Table of Contents Links
Question details
The user needs to resolve an accessibility error where PDF Table of Contents links are missing alternative descriptions.

- Product
- Device & OS
- not provided
- Scenario
- Evaluating PDF accessibility compliance using the PAC 3.0 checker.
- Observed behavior
- PAC 3.0 reports an 'Alternative description missing for annotation' error for every link located in the tagged PDF's table of contents.
Ensure you have access to an advanced PDF editor with an accessibility Tags panel and keep your PAC 3.0 report open to reference the specific table of contents links causing the error.
Add Alternate Text to Link Tags via Properties
Manually add meaningful alternative text directly to the Link tags in your PDF to pass the PAC 3.0 accessibility check.
Accessibility checking tools like PAC 3.0 require alternate text for all hyperlinks within a document, including those that are automatically generated in a Table of Contents. To fix the missing description error, you must apply the alternate text directly to the main Link tag. Avoid adding it to the Reference or Link OBJR tags, as they typically do not receive alternate descriptions.
Open your PDF document in a PDF editor equipped with accessibility tools and navigate to the Tags panel.
Expand the tag tree and locate the specific 'Link' tag associated with the Table of Contents entry that triggered the error.
Right-click the 'Link' tag and select 'Properties' from the context menu to open the Object Properties dialog box.
Locate the 'Alternate Text' field within the properties window and enter a meaningful, descriptive text that explains the destination or purpose of the link.
Click 'Close' to save the properties, save your PDF document, and run the PAC 3.0 checker again to confirm the error has been successfully resolved.

Manage and Edit PDF Links Easily with WPS Office
WPS PDF provides comprehensive tools to edit, manage, and optimize your PDF files. Easily adjust document properties, format your table of contents, and manage hyperlinks to ensure your documents meet your exact needs.
- 1. Open PDF in WPS Office: Launch WPS Office and open the PDF document you need to modify.
- 2. Access Link Tools: Navigate to the 'Edit' tab on the top ribbon and select the 'Link' tool to display all clickable areas in the document.
- 3. Edit Link Properties: Double-click the Table of Contents link you want to adjust to open its settings.
- 4. Save Changes: Make your desired modifications to the link destination or appearance, then save the document.

Frequently Asked Questions
Why do Table of Contents links need alternative text?
Screen readers and accessibility checkers rely on alternative text to describe the purpose and destination of a hyperlink. This ensures visually impaired users can clearly understand where the link leads, rather than just hearing 'link' without context.
What is the Link OBJR tag in a PDF?
The Link OBJR (Object Reference) tag represents the physical clickable bounding box of a hyperlink in a tagged PDF. Accessibility standards typically require the alternate text to be placed on the parent Link tag, not the OBJR tag.
Can I automate the process of adding alternate text to PDF links?
While some modern document authoring software can auto-generate basic PDF tags upon export, assigning meaningful alternate text for complex interactive elements like a Table of Contents often requires manual verification and editing in the PDF's Tags panel.
Will adding alternative text to tags change the visual appearance of my PDF?
No, alternative text is metadata stored securely within the document's hidden tag structure. It is invisible to sighted users but essential for screen readers and accessibility compliance tools.




