Messages you may see
- Acrobat Accessibility Checker: Figures alternate text - Failed (Figures require alternate text)
- PDF/UA-1 (ISO 14289-1) rule 7.3-1: Figure tags shall include an alternative representation or replacement text that represents the contents marked with the Figure tag as noted in ISO 32000-1:2008, 14.7.2, Table 323
- PDF/UA-1 (ISO 14289-1) rule 7.7-1: All mathematical expressions shall be enclosed within a Formula tag as detailed in ISO 32000-1:2008, 14.8.4.5 and shall have Alt or ActualText attributes
- PDF/UA-2 (ISO 14289-2) rule 8.2.5.28.2-1: A Figure structure element shall have at least one of the following properties: a) an alternate description (Alt property), as specified in ISO 32000-2:2020, 14.9.3; b) a replacement text (ActualText property) that represents the content enclosed by the Figure structure element
- PDF/UA-2 (ISO 14289-2) rule 8.2.5.29-1: The math structure type shall occur only as a child of a Formula structure element
- Matterhorn Protocol 1.1, 13-004: Figure tag alternative or replacement text missing.
- Matterhorn Protocol 1.1, 17-002: Formula tag is missing an Alt attribute.
What the rule requires
PDF/UA-1 (ISO 14289-1) handles graphics in clause 7.3 and mathematical expressions in clause 7.7. Automated checkers test:
- Rule 7.3-1: every
Figurestructure element has an/Altentry (a description) or an/ActualTextentry (the exact text shown, for example a word set as an image). - Rule 7.7-1: every
Formulastructure element has/Altor/ActualText.
PDF/UA-2 (ISO 14289-2) has the same requirement for figures in rule 8.2.5.28.2-1. For formulas, rule 8.2.5.29-1 adds that MathML math elements may only appear inside a Formula element.
In the Matterhorn Protocol 1.1, missing text is failure condition 13-004 (checkpoint 13, Graphics) and 17-002 (checkpoint 17, Mathematical expressions). Several related conditions need human judgement: 13-001 (a meaningful graphic is not tagged as Figure at all), 13-005 (ActualText used where alternative text is more appropriate) and the question whether the text actually describes the image.
The machine check only sees whether text is present. “image1.png”, “Picture” or a copied file name pass the check and help nobody. A purely decorative image should be an artifact rather than a Figure with meaningless text.
Why it matters
Screen readers announce a figure without alternative text as “graphic” or skip it. Blind users then miss everything the image conveys: the trend in a chart, the route on a map, the signature block on a scanned form, the content of an organisational chart. For formulas, screen readers may read out scattered symbols or nothing at all.
Alternative text also helps people who use read-aloud functions because of dyslexia or low vision, and it is shown as a tooltip in Acrobat. WCAG success criterion 1.1.1 (Non-text Content) requires a text alternative for every meaningful image; the W3C technique PDF1 shows the /Alt entry, PDF4 the artifact for decorative images.
Common causes
- Images, charts or logos were inserted without alternative text in the source document.
- In InDesign, the alt text source is left at From Structure without an XML structure, so no text is exported.
- Automatic tagging in Acrobat created Figure tags for decorative lines, backgrounds or empty frames. Adobe's help notes that Acrobat may tag artifacts as figures.
- Charts were pasted as pictures from a spreadsheet, losing the description.
- Mathematical expressions were exported as images or text fragments without a Formula tag and description.
- Alternative text was placed on a parent element. Adobe's help warns that alternative text on a parent tag prevents screen readers from reading its child tags, which Acrobat reports as “Nested alternate text”.
Example
12 0 obj
<< /Type /StructElem /S /Figure /P 3 0 R
/Pg 20 0 R /K 7 >>
endobj12 0 obj
<< /Type /StructElem /S /Figure /P 3 0 R
/Alt (Bar chart: applications per year, rising from 1,200 in 2021 to 2,050 in 2025.)
/Pg 20 0 R /K 7 >>
endobj/Artifact BMC
q 450 0 0 2 72 600 cm /Im3 Do Q
EMC40 0 obj
<< /Type /StructElem /S /Formula /P 33 0 R
/Alt (a squared plus b squared equals c squared)
/Pg 21 0 R /K 3 >>
endobjHow to fix it
Microsoft Word
- Right-click the picture, chart or shape and choose View Alt Text (Office 2019 to 2024: Edit Alt Text). Alternatively select it and choose Alt Text on its format tab, for example Picture Format.
- In the Alt Text pane, describe content and purpose in one or two sentences.
- For purely decorative objects, check Mark as decorative (Office 2019 to 2024: Decorative). The text box is then greyed out.
- Save as PDF with Document structure tags for accessibility checked.
Some Office versions can generate alt text automatically. Review generated text before export; in Microsoft 365 you can switch the feature off under File > Options > Accessibility.
Adobe InDesign
- Select the image frame and choose Object > Object Export Options. The dialog can stay open while you move from image to image.
- On the Alt Text tab, set Alt Text Source to Custom and enter the description, or choose an XMP source if the image metadata already contains a suitable description.
- For decorative objects, open the Tagged PDF tab instead and set Apply Tag to Artifact.
- Anchor images in the text flow at the point where they are referenced, so the description is read at the right place.
- Export with Create Tagged PDF.
Adobe Acrobat Pro
- Choose All tools > Prepare for accessibility > Add alternate text. Acrobat detects all figures and shows them one after the other.
- In the Set Alternate Text dialog box, enter a description for each figure. Current versions also offer a checkbox to mark a figure as decorative; Acrobat then treats it as an artifact. Select Save & Close.
- Alternatively, use Fix reading order: right-click a highlighted figure and choose Edit Alternate Text. Or select the Figure tag in the Accessibility tags panel, choose Properties and enter Alternate Text.
- For formulas, select the Formula tag in the Accessibility tags panel, open Properties and enter the alternate text.
- Run the check again and also review “Nested alternate text” and “Associated with content”.
Check your PDF
Upload the fixed file to see which machine-checkable criteria it meets now. The report lists the remaining problems with their pages.
Open the checkerQuestions
- How long should alternative text be?
- As short as possible while still conveying the content; Adobe's help also recommends keeping descriptions concise. For complex charts, give a short description in the alternative text and the data or key findings in the body text or a table.
- Should I start with “Image of …”?
- No. Screen readers already announce that the element is a graphic. Start with what the image shows or means.
- When is ActualText the right choice?
- When the image shows text, for example a word set in a decorative typeface or a scanned signature line with a name. ActualText then contains exactly that text. For everything else, use Alt.
Sources
- ISO 14289-1:2014 Document management applications – Electronic document file format enhancement for accessibility – Part 1: Use of ISO 32000-1 (PDF/UA-1) – International Organization for Standardization (ISO). Checked on 7 November 2026.
- ISO 14289-2:2024 Document management applications – Electronic document file format enhancement for accessibility – Part 2: Use of ISO 32000-2 (PDF/UA-2) – International Organization for Standardization (ISO). Checked on 7 November 2026.
- The Matterhorn Protocol 1.1 – PDF Association. Checked on 7 November 2026.
- Matterhorn Protocol checks (list of checkpoints and failure conditions) – PDF Association (Tagged PDF School). Checked on 7 November 2026.
- PDF1: Applying text alternatives to images with the Alt entry in PDF documents – W3C Web Accessibility Initiative (WCAG 2.2 Techniques). Checked on 7 November 2026.
- PDF4: Hiding decorative images with the Artifact tag in PDF documents – W3C Web Accessibility Initiative (WCAG 2.2 Techniques). Checked on 7 November 2026.
- Create and verify PDF accessibility, Acrobat Pro – Adobe (Acrobat User Guide), 23 July 2025. Checked on 7 November 2026.
- Edit document structure with the Content and Tags panels (Adobe Acrobat Pro) – Adobe (Acrobat User Guide), 3 May 2025. Checked on 7 November 2026.
- Reading Order tool for PDFs (Adobe Acrobat Pro) – Adobe (Acrobat User Guide), 9 May 2025. Checked on 7 November 2026.
- Add alternative text to a shape, picture, chart, SmartArt graphic, or other object – Microsoft Support. Checked on 8 November 2026.
- Creating accessible PDFs – Adobe (InDesign User Guide), 24 May 2023. Checked on 7 November 2026.