Fix NVDA Reading Errors in Tagged PDF Table of Contents Links
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.

- Product
- 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.
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.
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.
Launch your PDF in a professional PDF editor (such as Adobe Acrobat) and navigate to the 'Tags' pane on the left sidebar.
Expand the tag tree and find the <TOC> and <TOCI> (Table of Contents Item) tags that correspond to the problematic links.
Ensure that each <TOCI> tag contains properly structured text, a nested <Link> tag, and a valid destination (OBJR).
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.

Recreate the Table of Contents in the Source Application
If the PDF tag tree is too corrupted to fix manually, regenerating the PDF from the original source file is often the fastest and most reliable method.
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. Open your document: Launch WPS Writer and open the source document you want to convert.
- 2. Generate TOC: Navigate to the 'Reference' tab and click 'Table of Contents' to insert a cleanly formatted, automated TOC.
- 3. Export to PDF: Click 'Menu' > 'Export to PDF', ensuring the output settings are configured to retain hyperlinks and document structure.

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.




