Other PDF Issues

Fix NVDA Reading Errors in Tagged PDF Table of Contents Links

Phi Hung VoPhi Hung Vo Nov 10, 2026 869 views

Question details

The user needs to resolve an issue where the NVDA screen reader incorrectly reads table of contents (TOC) entries in a tagged PDF document.

Fix NVDA Reading Errors in Tagged PDF Table of Contents Links
Product
PDF
Device & OS
not provided
Scenario
Navigating a tagged PDF document using the NVDA screen reader for accessibility purposes.
Observed behavior
NVDA reads the tagged PDF table of contents entries incorrectly due to improperly structured link annotations, tags, or destinations.
Before you start

Ensure you have a professional PDF editor with accessibility tagging features installed, and keep your NVDA screen reader updated to the latest version for accurate testing.

Solution 1Recommended

Inspect and Repair the PDF Tag Tree and Link Annotations

Manually verify and correct the link structures and tag tree in your PDF editor to ensure NVDA can read them accurately.

Screen readers rely on the hidden tag structure of a PDF to understand document flow. If TOC entries lack proper <TOCI> or <Link> tags, NVDA will fail to announce the links correctly.

1
Open the Tags panel

Launch your PDF in a professional PDF editor (such as Adobe Acrobat) and navigate to the 'Tags' pane on the left sidebar.

2
Locate the TOC tags

Expand the tag tree and find the <TOC> and <TOCI> (Table of Contents Item) tags that correspond to the problematic links.

3
Verify link structure

Ensure that each <TOCI> tag contains properly structured text, a nested <Link> tag, and a valid destination (OBJR).

4
Fix missing annotations

Right-click any incorrect tags to edit properties, or use the 'Find' tool in the Tags panel to locate unmarked annotations and tag them correctly as links.

Inspect and Repair the PDF Tag Tree and Link Annotations
Run an Accessibility Check: Always run the built-in accessibility checker after making manual tag adjustments to catch any lingering structural errors before publishing.
Create Accessible PDFs Easily

Use WPS Office to Generate Well-Structured PDFs

WPS Office provides built-in tools to create automated Tables of Contents and export them as highly compatible, structured PDFs, significantly reducing the risk of NVDA screen reader errors.

  1. 1. Open your document: Launch WPS Writer and open the source document you want to convert.
  2. 2. Generate TOC: Navigate to the 'Reference' tab and click 'Table of Contents' to insert a cleanly formatted, automated TOC.
  3. 3. Export to PDF: Click 'Menu' > 'Export to PDF', ensuring the output settings are configured to retain hyperlinks and document structure.
Easily generate accurate and clickable Tables of Contents with one click.Seamlessly export Word documents to highly compatible structured PDF formats.Fully compatible with Microsoft Office formats (DOCX, PPTX, XLSX).Lightweight, fast, and free to use for everyday document accessibility tasks.
microsoft office alternative - wps office

Frequently Asked Questions

Why does NVDA read 'blank' or skip links in my PDF Table of Contents?

This usually happens when the PDF is missing <Link> tags entirely, or the link annotation lacks a defined destination (OBJR) in the document's tag tree, leaving the screen reader with no actionable data.

Can I fix PDF accessibility tags without Adobe Acrobat?

While Acrobat is the industry standard for deep manual tag tree manipulation, you can easily bypass manual tagging by fixing the source document in a word processor like WPS Writer and re-exporting it properly as a PDF.

What are <TOCI> tags in an accessible PDF?

<TOCI> stands for Table of Contents Item. In a properly tagged PDF, these tags enclose the individual entries of a TOC, ensuring screen readers like NVDA understand the relationship between the descriptive text and the hyperlink.

How do I test if my PDF Table of Contents is accessible?

You can use the built-in accessibility checker in your PDF editing software, or manually navigate the PDF using the NVDA screen reader and the 'Tab' key to ensure each TOC link is announced and functions correctly.