PDF Security & Access Issues

How to Fix Tagged PDF Table of Contents Issues with NVDA and JAWS

Khadija KhanKhadija Khan Nov 10, 2026 870 views

Question details

Users need to resolve accessibility issues where tagged PDF table of contents (TOC) links are not read correctly by screen readers like NVDA or JAWS.

How to Fix Tagged PDF Table of Contents Issues with NVDA and JAWS
Product
PDF
Device & OS
not provided
Scenario
Navigating a tagged PDF document using screen reading software, particularly when trying to interact with table-of-contents links inside web browsers or desktop PDF readers.
Observed behavior
Screen readers fail to read the table of contents accurately or navigate properly due to incorrect structural tags, broken link destinations, or missing alternate text.
Before you start

Ensure you have a professional PDF editor capable of viewing and modifying hidden document accessibility tags, and update your screen reader software to its latest version for accurate testing.

Solution 1Recommended

Inspect and Repair PDF Tags and Link Destinations

Use a professional PDF editor with accessibility features to manually verify and fix the Table of Contents tags and link destinations.

Accessibility issues in PDFs often stem from a broken tag tree. Screen readers rely heavily on standard tags (like <TOC> and <TOCI>) to understand document hierarchy and navigation.

1
Open the Accessibility Tool

Open your PDF in an advanced PDF editor (such as Adobe Acrobat Pro) and access the Accessibility tools panel from the main menu.

2
Inspect the Tag Structure

Open the Tags pane on the left navigation bar. Expand the tag tree to locate the <TOC> (Table of Contents) and <TOCI> (Table of Contents Item) tags. Ensure they are nested in a logical order.

3
Verify Link Destinations and Alternate Text

Check the properties of the TOC link text. Ensure each link has a valid destination pointing to the correct page in the document, and add descriptive alternate text if the link text itself is not descriptive enough.

4
Run an Accessibility Check

Use the built-in Accessibility Checker to scan the document. Review the report and fix any remaining flagged errors related to navigation and tagging.

Inspect and Repair PDF Tags and Link Destinations
Testing Recommendation: After fixing the tags, always test the document by reading it aloud using both NVDA and JAWS to confirm the issue is fully resolved.
Manage PDFs easily with WPS Office

Organize and Manage PDF Table of Contents in WPS Office

WPS Office provides a highly intuitive PDF editor that lets you easily create, modify, and manage clear document structures and bookmarks, ensuring a smooth reading experience for all your users.

  1. 1. Open Your PDF: Launch WPS Office and open your PDF document using the built-in WPS PDF tool.
  2. 2. Access the Navigation Panel: Click on the 'Bookmarks' or 'Outline' icon located on the left-hand sidebar to view the document's current structure.
  3. 3. Edit the Table of Contents: Right-click any existing bookmark to rename it, modify its page destination, or add new entries to ensure logical document navigation.
  4. 4. Save Your Document: Click 'Save' or 'Save As' to preserve your cleanly structured navigational bookmarks as a standard PDF file.
Easily add, edit, or reorganize PDF bookmarks and table of contents entries.High compatibility with standard PDF formats ensuring seamless cross-platform reading.Built-in document reading features for a focused and distraction-free experience.Lightweight, fast-loading interface suitable for all desktop and mobile devices.
microsoft office alternative - wps office

Frequently Asked Questions

Why do JAWS and NVDA fail to read my PDF Table of Contents?

This usually happens when the PDF lacks proper structural tags (like <TOC>), contains incorrect link destinations, or uses complex formatting that disrupts the logical reading order that screen readers rely on.

Can I test my PDF's accessibility without using a screen reader?

Yes. Most advanced PDF editors include a built-in Accessibility Checker tool that scans the document for missing tags, alternative text, and reading order issues, providing a report of elements that need fixing.

Does exporting a document to PDF automatically create accessible tags?

Not automatically. When exporting from word processors or publishing software, you must explicitly check the option to 'Create tagged PDF' or 'Preserve document structure' in the export settings to generate the necessary accessibility metadata.

Why do PDF links work in a desktop app but fail when opened in a web browser?

Web browsers use their own built-in PDF viewers, which often lack full support for advanced PDF accessibility tags and link routing. If a tag structure is slightly flawed, desktop apps might compensate for it, while browser viewers may fail.