AccessibilityPDF — Martin Schrammel AB

Examples

Common PDF errors and repairs that only look correct

Here are six recurring mistakes. Use the examples to check whether a repair actually helps the reader.

Applies to
Our constructed failure scenarios for editors and reviewers
Sources checked
Language

Start with the barrier, before the report colour

An error invites the quickest change that removes its marker. But a technical report does not always describe the complete reader problem. First state what someone needs to do at that location.

For a heading, the task is finding and understanding a section. For a table, interpreting and comparing values. For a chart, obtaining the important information conveyed visually. A clear task lets you judge whether the repair helps or merely changes the report.

Then seek the cause. Repeated problems can arise from an export setting, a style or a misunderstood content type. Repairing the cause can resolve several defects together. Local renaming can instead create an apparently orderly structure disconnected from meaning.

Problem, insufficient repair and better check

ProblemInsufficient actionCheck instead
Heading missing from navigationMake the text larger.Heading tag, level and practical heading navigation.
Image lacks alternative textWrite Image.Whether the important information or function is conveyed.
Incorrect reading orderMove text visually.Tag order, content within tags and practical reading.
Table value lacks contextMark every cell TH.Which cells are headers and how they relate to data.
Unreadable scanRun OCR and stop.Text accuracy, structure and reading tasks.
Unknown-tag validation errorMap everything to P.The appropriate standard meaning of each content item.
This table scrolls horizontally.

Why a greener report can mislead

Suppose a table has incorrect tags. Someone converts everything to ordinary paragraphs, removing a table-specific warning. The report has fewer errors, but readers may have lost table navigation. This is why repairs must be assessed against the content’s function.

This is a constructed failure scenario, not a measured finding from a named tool.

A heading fault originating in the source

A report has ten visually identical subheadings. Six appear in the screen reader’s heading list; four are missing. First establish whether the missing four use the same semantic source style. Their appearance may have been copied manually while the others use a heading style.

The repair then starts in the source: apply the correct heading style, check its level and export again. In the PDF, verify that all ten are discoverable and no ordinary introduction was accidentally promoted to a heading. The list should represent the document’s outline, not collect every large piece of text.

Without the source, repair may need to happen in the PDF structure. The principle remains: identify the correct content, assign the right role and level, and test navigation. Record the likely source problem so the next edition does not repeat it.

Three questions after every repair

  • Is the same information still present?
  • Can readers find, understand or use it more effectively?
  • Was the final file checked by a method capable of detecting this particular problem?

When to return to the source

If repair requires guessing a table’s meaning, rewriting a legal instruction or interpreting an unreadable number, let the document owner resolve it. Technical confidence and convincing wording cannot replace source evidence.

Distinguish a document defect from an incomplete investigation too. An untested form is “not checked”, neither “working” nor “failed”. If a tool stops, investigate the run before assessing the file. Clear status terms let others continue without guessing what previous notes mean.

Sources

  1. PDF9: Heading tagsW3C
  2. PDF1: Text alternatives for imagesW3C
  3. PDF3: Reading and tab orderW3C
  4. PDF6: Table markupW3C
  5. PDF7: OCR for scanned PDFsW3C
  6. Tagged PDF Best Practice Guide: SyntaxPDF Association

Examples are our own unless stated otherwise. These guides distinguish legal requirements, standards and practical advice. Passing an automated check is not a complete assessment of document accessibility.

All guides

Need help with your PDFs?

The service is in development. Sign up for an email when we open. You can read the full knowledge library in the meantime.

Get a launch notice