To repair a complex PDF table, first describe its logical grid and the headers that explain each cell. Then compare that description with the exported structure, correct the mismatches, and test the reader's experience. Starting with the meaning prevents a common mistake: making the tag tree look regular while associating a value with the wrong period, category, or unit.
Write down the relationships before editing tags
Imagine a fictional service report with departments in rows and two groups of columns: planned activity and completed activity. Each group contains a count and a cost. A cell containing '120' is ambiguous without its department, group, and measure. Write the intended interpretation as a sentence: 'The community team completed 120 visits.' That sentence becomes a practical test of the structure.
Decide whether the arrangement is genuinely tabular. A two-column page used to position a photograph next to a paragraph is not necessarily a data table. Conversely, a borderless comparison can still express row and column relationships. Inspect the information rather than classifying it by the presence of lines or shading.
Inspect the logical grid and cell roles
W3C technique PDF6 explains table structures such as Table, TR, TH, and TD, and the use of row and column spans. These structures express relationships that need to remain available when the visual grid is not. A spanning header must occupy the intended logical area; visually merged text alone is not sufficient evidence.
For the service report, count the logical columns after accounting for spans. Check that every data value belongs to the intended row and that any empty position has a deliberate meaning. Do not delete a blank cell merely to make a checker stop reporting a grid mismatch. Determine whether it means not applicable, not reported, or a genuinely empty intersection, and preserve that interpretation.
| Value | Row context | Column context | Reader should understand |
|---|---|---|---|
| 150 | Community team | Planned activity; visits | The team planned 150 visits |
| 120 | Community team | Completed activity; visits | The team completed 120 visits |
| 8,000 | Community team | Completed activity; cost in stated currency | The completed activity cost 8,000 in the report's currency |
Correct headers and spans with the target standard in mind
W3C technique PDF20 demonstrates checking and correcting exported cell roles and spans in a table editor. Its screenshots illustrate a procedure rather than a promise about the current location of every menu. In your editor, inspect the actual cell properties, verify the logical relationships, and save a new revision before comparing results.
For simple relationships, row or column scope can describe a header's role. More complex arrangements can require explicit header associations. The PDF Association's Well-Tagged PDF specification sets out the PDF 2.0 treatment of regular tables, scope, and header relationships. Apply the rules for the chosen PDF version and conformance target; do not copy a partial attribute recipe between profiles without checking it.
If the authoring tool cannot reliably express a complicated arrangement, consider simplifying the presentation. Two clearly titled tables may communicate a comparison more effectively than one grid with several layers of merged headings. Make that decision with the content owner so simplification does not remove a relationship readers need.
Review continuation pages and explanatory notes
A table can continue across a page boundary without becoming a different logical table. Check that continuation content retains its context and that repeated visual headings do not produce confusing duplicate content in the reading sequence. Place the caption, unit statement, and any qualifying notes where their relationship is understandable. A footnote marker that is visible but unexplained can change the interpretation of a number.
- Select a body cell under each group of headings and identify all context needed to interpret it.
- Repeat the task for a row header, a spanning cell, an empty position, and the first row on a continuation page.
- Check that the PDF's values match the approved source, independently of the structure review.
- Run the chosen validator, record its profile and version, and investigate new structural findings.
- Use a suitable viewer and screen reader to navigate the table, recording the actual header announcements and any unresolved limitations.
Record a meaningful acceptance result
A useful review record names the table, PDF revision, expected relationships, test environment, and findings. 'Table passed' is too vague to explain whether the reviewer checked a simple first row or the difficult grouped headers. Keep unanswered interpretation questions visible until the content owner resolves them.
The PDF tag viewer can support inspection, and the screen-reader guide helps make the reading test repeatable. If you also publish HTML, separately verify the converted tables. A correct source table and a correct HTML result are related evidence, but each delivered format needs its own check.
Frequently asked questions
Are merged cells always inaccessible?
A merged visual cell is not automatically a failure, but its span and relationships must be represented correctly and remain understandable. Simplify a complicated design when possible, and verify necessary spans against the target PDF profile and reader tasks.
Can I mark every bold cell as a header?
Bold formatting is not a reliable definition of a header. Determine which cells identify other cells, then assign roles and relationships to match that meaning. A total value or emphasized exception may be bold without being a header.
Does an automated table pass prove that the headers are right?
Automated validation can detect many structural inconsistencies but cannot reliably determine the author's intended interpretation of every value. Check representative values with their row, column, unit, and note context, and record a reading test.
Sources
The statements above rest on the primary sources below. Where a source is a law or standard, the version and date named in the text are the ones checked on the review date. This guide is general information, not legal advice.
- W3C PDF6: Table elements
- W3C PDF20: Repairing mistagged tables
- PDF Association: Well-Tagged PDF 1.0 . PDF 2.0 table regularity and header relationships; do not apply version-specific rules indiscriminately.
Keep reading
Excel to accessible PDF: tables and export checks
Prepare an Excel workbook for PDF export, inspect table headers and page breaks, and test whether the exported data remains understandable.
Read the guide →How to test a PDF with a screen reader
A repeatable screen reader test for PDFs with NVDA, JAWS, or VoiceOver: which viewer to open the file in, the keystrokes to use, what to listen for, and independent data on which viewers expose tags.
Read the guide →See the tag tree an export wrote
Read the logical structure of any PDF in the browser: headings, tables, figures, and role maps.
Open the tag viewer →