PDF/UA-1 · CLAUSE 7.10

Optional content (layers) is configured incorrectly

An optional content configuration dictionary has no Name, or uses the forbidden AS key for automatic state changes.

Rule 7.10-2 ISO 14289-1 Object: PDOCConfig

Why it matters

Users cannot tell what a layer contains, and automatic visibility changes can hide content from assistive technology without warning.

How to fix it

  • Give every optional content configuration a human-readable Name.
  • Remove the AS entry so layer visibility does not change automatically based on usage.
  • Flatten layers before publishing when they are not needed by the reader.
WCAG 1.3.1 Info and Relationships (A)

What the standard says

The AS key shall not appear in any optional content configuration dictionary

Check your own PDF

Validate a file against PDF/UA-1 and see whether this rule fails in your document.

curl -sS -X POST "https://api.ua1.dev/api/validate?format=compact&profile=ua1" \
  -F "file=@document.pdf"