Includoc, home

PDF/UA explained: PDF/UA-1, PDF/UA-2 and the Matterhorn Protocol

PDF/UA is the ISO standard for accessible PDF files. What PDF/UA-1 and PDF/UA-2 require, how Matterhorn and validators test them, and the identifier.

Last updated

A PDF beside a standards book and a checklist of requirements

PDF/UA (PDF for Universal Accessibility) is the ISO standard that defines what a PDF file must contain to be accessible to people using assistive technology. It's published as ISO 14289. Part 1, PDF/UA-1 (ISO 14289-1:2014), applies to PDF 1.7 files, and Part 2, PDF/UA-2 (ISO 14289-2:2024), applies to PDF 2.0 files. The Matterhorn Protocol, from the PDF Association, turns PDF/UA-1 into a list of failure conditions: some can be tested by software, and some need a person. Validators such as veraPDF and PAC test the software-checkable ones.

What PDF/UA requires

In plain English, a PDF/UA file must meet requirements in these areas:

  • Structure. The file is tagged. All real content is tagged in a logical reading order, and everything else (page numbers, running headers, decoration) is marked as an artifact. Tags are standard types, or custom types mapped to standard ones, and they match what the content is: headings are tagged as headings, lists as lists, tables as tables.
  • Text. Every font is embedded, and every character maps to Unicode, so text reads and copies correctly. The document's language is declared, along with any changes of language.
  • Images and math. Figures and formulas have alternate text.
  • Tables. Header cells are tagged as headers, and data cells can be connected to them.
  • Metadata. The file has a title in its metadata, shows that title in the window bar, and declares PDF/UA conformance with an identifier.
  • Interaction. Links, form fields and other annotations are tagged and described; the tab order follows the structure; dynamic XFA forms aren't used.
  • Security. Encryption doesn't stop assistive technology from reading the content.

PDF/UA also points to WCAG for some content questions, such as conveying information through color or contrast. Our WCAG vs. PDF/UA guide explains where the two standards overlap and where they differ.

PDF/UA-1 vs. PDF/UA-2

PDF/UA-1PDF/UA-2
StandardISO 14289-1 (first published in 2012; current edition 2014)ISO 14289-2:2024
Based onPDF 1.7 (ISO 32000-1)PDF 2.0 (ISO 32000-2)
Tag setThe PDF 1.7 standard structure typesThe PDF 2.0 structure types, which add elements such as Title, Aside and FENote
Test checklistThe Matterhorn ProtocolValidator profiles such as veraPDF's
Tool supportBroad: most authoring and remediation tools, and every major validatorGrowing: newer tools and validators

The PDF Association also publishes Well-Tagged PDF (WTPDF) 1.0, a free specification for tagging PDF 2.0 files. Its accessibility conformance level is aligned with PDF/UA-2, so the two are often mentioned together.

Which should you target? For most organizations today, PDF/UA-1 is the practical choice: it's what most authoring tools produce and what PAC and most remediation workflows test. PDF/UA-2 matters as more tools move to PDF 2.0. Neither is named in the ADA Title II rule, which requires WCAG 2.1 AA.

The Matterhorn Protocol

The PDF/UA standard says what a conforming file must contain, but not how to test it. The Matterhorn Protocol, published free by the PDF Association, fills that gap for PDF/UA-1. It breaks the standard into 31 checkpoints, such as real content tagged, metadata, graphics, headings, tables, annotations and fonts, and 136 failure conditions. Each failure condition is labeled as either machine-checkable or requiring human judgment. In the current version, Matterhorn Protocol 1.1 (2021), 87 failure conditions can be checked by software, 47 usually need human judgment, and 2 have no specific test.

Examples:

Failure condition (in plain English)How it's tested
Content is neither tagged nor marked as an artifactMachine
A figure has no alternate textMachine
The alternate text doesn't describe the figureHuman
A font isn't embeddedMachine
Text that looks like a heading isn't tagged as oneHuman
The reading order isn't logicalHuman
The document's title is missing from the metadataMachine
The PDF/UA identifier is missingMachine

This split is the most important thing to understand about PDF/UA checking. A validator can only test the machine-checkable conditions. "PAC passed" means the machine checks passed, not that the file conforms to PDF/UA. Conformance also needs a person to work through the human-judgment conditions.

Validators

ToolWhat it isGood to know
veraPDFFree, open-source validator from the PDF Association and the Open Preservation FoundationValidates PDF/UA and PDF/A, and runs from the command line or a desktop app. Includoc uses it.
PAC (PDF Accessibility Checker)Free Windows app, currently PAC 2026Tests machine-checkable PDF/UA (Matterhorn) conditions and many WCAG requirements, and has a screen reader and structure preview for the visual checks
Acrobat Pro's Accessibility CheckerBuilt into Adobe Acrobat ProUses Adobe's own rules, so its results don't map one to one to PDF/UA
IncludocOnline checkerveraPDF validation plus our own checks, with each result mapped to Matterhorn, PAC and Acrobat wording

Different validators sometimes disagree on edge cases, so specialists often use two. Whatever you use, record the tool and version in your report.

Common PDF/UA failures and what they mean

These are among the failures people search for most often. Each links to a page with step-by-step fixes.

What the report saysWhat it means in plain English
Content is tagged or artifactedSome text or graphics are neither tagged as content nor marked as decoration
Non-standard structure type is remappedA custom tag, often named after a Word or InDesign style, isn't mapped to a standard tag
Figure tag problemsA Figure tag has no alt text, or holds content that isn't an image
Link annotations in Link tagClickable links aren't inside Link tags in the tag tree
Widget annotations in Form tagForm fields aren't inside Form tags
Annotation has alt textA comment, stamp or other annotation has no description
TH has associated cellsA table header cell isn't linked to the data cells it describes
Fonts are embeddedA font the text needs isn't included in the file
PDF/UA identifier missingThe metadata doesn't declare PDF/UA conformance

PAC also reports some checks that go beyond the PDF/UA-1 failure conditions, such as figure has bbox, which helps figures display correctly when content is reflowed or magnified.

The PDF/UA identifier

The PDF/UA identifier is a small piece of metadata (in the file's XMP metadata) that declares "this file conforms to PDF/UA". For PDF/UA-1, it's the pdfuaid:part property with the value 1. PDF/UA-2 files use the value 2 and also record the revision year.

  • PAC and veraPDF report a missing identifier as a failure, even though it doesn't change what anyone hears. See PDF/UA identifier missing.
  • Only add it when the file actually conforms. Adding the identifier to a file that fails other requirements is a false claim, and it can mislead the next person who checks the file.

Is PDF/UA required by law?

Not directly, in the US. The ADA Title II and HHS Section 504 web rules require WCAG 2.1 Level AA, and they apply to the documents you post. When the Department of Justice wrote the Title II rule, it considered PDF/UA and declined to add it as a separate technical standard. But building to PDF/UA is a sound technical foundation for meeting WCAG in a PDF, and its free validators give you consistent, repeatable checks. Some contracts and procurement documents ask for PDF/UA explicitly, so check what yours require. Our ADA Title II guide covers the rule itself.

Fix it automatically

Includoc validates every PDF with veraPDF's PDF/UA-1 profile plus our own WCAG 2.1 AA checks, and maps each result to its Matterhorn checkpoint and the matching PAC and Acrobat message. When we fix a file, we tag all content or mark it as an artifact, embed the document title and language, fix the role map and tag annotations. We add the PDF/UA identifier only after every machine check passes, and we list the human-judgment items for you to confirm. Problems we can't safely fix after the fact, such as fonts that aren't embedded, are flagged with instructions to re-export from the source.

Upload your PDF to fix this automatically

Free check in seconds. Files are deleted within 24 hours.

Check your PDF

Standards

Standards references: The PDF/UA identifier is missing
Standard or toolReference
PDF/UA-1 (ISO 14289-1)Clause 5
Matterhorn ProtocolCheckpoint 06-002
PAC wordingPDF/UA identifier missing
Standards references: Some content isn't tagged or marked as decoration
Standard or toolReference
WCAG 2.1
PDF/UA-1 (ISO 14289-1)Clause 7.1
Matterhorn ProtocolCheckpoint 01-005
PAC wordingContent is tagged or artifacted
Acrobat ruleTagged content
Standards references: Some fonts aren't embedded
Standard or toolReference
PDF/UA-1 (ISO 14289-1)Clause 7.21.4.1
PAC wordingFonts are embedded

Sources