Reference

PDF/A error reference

What each PDF/A-1b failure means, why a document ends up with it, and what to do about it.

Each entry answers the question first, then gives the clause, the cause and the fix. If you have a document in front of you and want to know what is wrong with it, the validator runs in your browser and names the failing checks — nothing is uploaded. For background on the standard itself, start with the guides.

File structure

6.1.x — file header, trailer, xref, object framing, limits

Encrypted document
PDF/A forbids encryption of any kind, including permission-only owner passwords. Why, and how to produce an unencrypted archival copy.
Embedded files
PDF/A-1 forbids file attachments. Which parts allow them, and what to do with a document that has one.
LZW compression
PDF/A forbids the LZWDecode filter. Where it still comes from and how to re-encode with Flate instead.
Broken cross-reference table
A damaged xref table means offsets do not point where they claim. Why it happens, what a validator can still tell you, and how to repair it.

Colour

6.2.2 OutputIntent, 6.2.3.x device colours, 6.2.9–10

Missing OutputIntent
PDF/A requires an OutputIntent with an embedded ICC profile when device-dependent colour is used. What that means and how to add one.
Device colour without OutputIntent
Using DeviceRGB, DeviceCMYK or DeviceGray in PDF/A-1b requires a matching OutputIntent. What the check means and the two ways out.

Transparency

6.2.8 transfer functions, 6.4 soft masks/blend modes/alpha

Transparency in PDF/A-1
PDF/A-1 is based on PDF 1.4 but forbids transparency groups, soft masks and non-Normal blend modes. Why, and what to do about it.
Transfer function present
Transfer functions, halftones and other device-level rendering controls are restricted in PDF/A-1b. What triggers the check and how to clear it.

Fonts

6.3.x embedding, subsets, metrics, encoding

Font not embedded
Why "font not embedded" fails PDF/A-1b, what causes it, and how to fix it by embedding the font program or converting the document.
Glyph not in font
A character used on the page has no glyph in the embedded font subset. Why that fails PDF/A-1b and how to fix the subset.

Annotations

6.5.x annotation types and dictionaries

Missing appearance stream
Every annotation in a PDF/A file needs a normal appearance stream so its rendering does not depend on the viewer. How to add one.

Actions

6.6.x action types and additional actions

JavaScript or launch action
PDF/A forbids executable content — JavaScript, launch actions and other actions with side effects. What triggers this and how to remove it.

Metadata

6.7.x XMP metadata, extension schemas, PDF/A identifier

XMP / Info mismatch
When Title, Author or the dates disagree between XMP and the Info dictionary, PDF/A-1b fails. Why the duplication exists and how to reconcile it.
gopdfrab runs 159 checks across 11 groups
This reference covers the failures real documents hit most often, not every registered check. The full registry is queryable from the library, and every issue reported by the validator carries its own clause and description.