ReferencesConversion

Recognize the roles in a PDF tag tree

A practical PDF tag-role reference with heading, paragraph, list, table and figure examples, plus the limits of tag presence and artifact handling.

At a glance

PDF tags describe semantic relationships such as headings, paragraphs, list items and table cells. Correct roles and a meaningful sequence help readers navigate. A populated tree or familiar role name is not sufficient: the tags must represent the actual content, and decorative artifacts are handled separately from meaningful structure.

Worked exampleIllustrative data

This is an explanatory outline, not raw PDF syntax or a complete standards tree.

Simplified semantic specimen
ContentIntended roleReview question
Application instructionsH1Is it the main heading?
Who can applyH2Does hierarchy reflect the section?
First instructionPIs it one coherent paragraph?
Required documentsL / LIAre labels and bodies associated?
Fee scheduleTable / TR / TH / TDCan each value be identified?

Scroll sideways to see all columns. Use arrow keys when the table is focused.

Common roles and what to inspect

This dictionary introduces commonly encountered roles. PDF versions, custom role mapping and conformance specifications can affect the full vocabulary. Consult the relevant standard and validator for normative requirements.

Common PDF semantics
RolePurposeInspect
Document / SectGroup the document and sectionsMeaningful nesting and content coverage
H1–H6 / PHeadings and paragraphsHierarchy, text boundaries and sequence
L / LI / Lbl / LBodyList and item relationshipsMarker and item text remain associated
Table / TR / TH / TDTable, row, header and data cellsCorrect relationships, spans and values
FigureMeaningful non-text contentAppropriate description or data alternative
LinkLink content and relationshipPurpose and destination
FormForm-related contentNames, roles, values and actual task behavior

Scroll sideways to see all columns. Use arrow keys when the table is focused.

Decoration should not become body content

Decorative content can be marked as an artifact instead of entering the meaningful reading sequence. Repeating furniture such as a purely decorative line is different from a consequential footnote, label or instruction.

Do not mark confusing content as decorative merely to remove a checker finding. Compare it with the source and ask whether a reader needs the information. A company logo that communicates identity may need different treatment from a background flourish.

  • Keep meaningful captions and qualifications in the reading sequence.
  • Review repeated headers and footers in context.
  • Do not equate an artifact marker with a missing tag defect.

Review the relationships, not just the names

A paragraph tagged as a heading can create false navigation. A table tagged as paragraphs can lose its data relationships. Conversely, a correctly named role in the wrong sequence can still make the document confusing.

Use a tag viewer to inspect the structure, then test the exact revision with appropriate manual and assistive-technology checks. For detailed tables, forms, languages and title settings, follow the existing specialist guides and primary techniques linked below.

Sources and scope

Methods, worksheets and illustrative examples are DocAccessible editorial contributions. These references support the technical or product details described above. W3C techniques are informative guidance; they are not a certification scheme.

  1. W3C PDF9: PDF headings

    Heading tags communicate document structure.

  2. W3C PDF21: list tags

    List, item, label and body structure.

  3. W3C PDF6: table markup

    Table, row, header and data-cell structure in PDF.

  4. W3C PDF4: decorative artifacts

    Keeping decorative content out of the meaningful reading sequence.

  5. W3C PDF12: form field names, roles and values

    Programmatic field information required for usable PDF forms.

Written by the DocAccessible team under our editorial policy. Suggest a correction if a source or product detail needs updating.

Put the method to work.

Choose the right next step for your document.

View a PDF’s tag tree