Appropriate nesting – Failed
Acrobat’s “Appropriate nesting – Failed” means heading levels are out of order, often a skipped level. How heading outlines work and how to fix them.
Last updated
This message comes from Adobe Acrobat's Accessibility Checker.
Appropriate nesting – Failed is the result of the only rule in the Headings category of Adobe Acrobat Pro's Accessibility Checker. It means the document's heading tags (H1 to H6, the labels in its hidden structure that mark headings for assistive technology) aren't nested properly. A common cause is a skipped level, such as an H3 straight after an H1. Headings are how many screen reader users skim a document, so their levels need to form a clean outline.
What this means
Heading levels should work like an outline:
H1for the document's title or main heading.H2for the main sections.H3for subsections inside anH2, and so on.
Going down, levels go one step at a time: H2 to H3, never H2 to H4. Going back up can jump: an H4 followed by a new H2 section is fine.
PDF/UA, the ISO standard for accessible PDFs, is stricter than WCAG here. Adobe's own help notes that heading order is advisory rather than required under WCAG. PDF/UA-1 does require it: if a document uses numbered headings, the first must be H1, and levels can't be skipped on the way down. PDF/UA also says not to mix the generic H tag with numbered H1 to H6 tags. So a file can pass Acrobat's rule and still fail PAC, the free PDF Accessibility Checker.
Common causes:
- Headings chosen for their look in the source, such as picking Heading 3 because it's the right size.
- No
H1, because the document title is just large text. - Documents merged from several files, each with its own outline.
- Autotagging, which guesses heading levels from font size.
One trap works the other way: a document with no heading tags at all can pass this rule, because there's nothing to nest. It's still hard to navigate, and Includoc flags multi-page documents with no headings separately.
Why it matters
Screen reader users often bring up a list of headings, or jump from heading to heading, to find what they need. Skipped levels suggest missing sections and make the outline hard to follow. Missing headings are worse: people have to listen from the start to find anything. This affects WCAG 2.1 success criteria 1.3.1 Info and Relationships and 2.4.6 Headings and Labels, and it matters for people with cognitive disabilities, who rely on a clear structure.
How to fix it in Acrobat Pro
- Sketch the outline first: list the document's title and section headings, and decide the right level for each.
- In the Accessibility Checker panel, expand Appropriate nesting, right-click an item and choose Show in Tags Panel.
- For each heading at the wrong level, right-click its tag, choose Properties and change the type, for example from
H3toH2. - Tag any text that looks like a heading but is tagged as a paragraph with the right heading level. Change "fake" headings, such as bold body text tagged as a heading, back to
P. - If the file mixes the generic
Htag with numbered headings, change them all to numbered levels. - Right-click the rule and choose Check Again, then check the file in PAC for the stricter PDF/UA rules.
Fix it in the source file
Heading levels are much easier to get right in the source:
- Word: apply Heading 1, Heading 2 and so on from the Styles gallery. To change how headings look, modify the style instead of choosing a different level. View > Navigation Pane shows the outline as you work, and Word's Accessibility Checker gives a tip when a document doesn't use heading styles.
- InDesign: map each heading paragraph style to
H1toH6in its Export Tagging settings. - Everywhere: use one
H1for the title, and don't skip levels on the way down.
Export with tags turned on, and the PDF's headings will follow your outline. Bookmarks built from headings will follow it too.
Fix it automatically with Includoc
Includoc fixes the mechanical part automatically. We renumber headings so levels go down one step at a time, and convert generic H tags to numbered H1 to H6 tags.
Choosing the right levels takes judgment, so it's assisted. Our AI detects headings from font size and weight, including text that looks like a heading but isn't tagged as one, and proposes a level for each. You confirm the outline in the headings panel on the review screen before you download the file.
Upload your PDF to fix this automatically
Free check in seconds. Files are deleted within 24 hours.
Standards
| Standard or tool | Reference |
|---|---|
| WCAG 2.1 | |
| PDF/UA-1 (ISO 14289-1) | Clause 7.4.2 |
| Matterhorn Protocol | Checkpoint 14-002, Checkpoint 14-003 |
| Acrobat rule | Appropriate nesting |
| Standard or tool | Reference |
|---|---|
| WCAG 2.1 | |
| PDF/UA-1 (ISO 14289-1) | Clause 7.4.4 |
| Matterhorn Protocol | Checkpoint 14-006, Checkpoint 14-007 |
| Acrobat rule | Appropriate nesting |
| Standard or tool | Reference |
|---|---|
| WCAG 2.1 | |
| PDF/UA-1 (ISO 14289-1) | Clause 7.4 |
| Matterhorn Protocol | Checkpoint 14-001 |
Related errors
- Bookmarks – Failed: bookmarks are usually built from headings, so fix the headings first.
- List items and Lbl and LBody – Failed: another part of the document's structure that Acrobat checks.
For the full workflow, read How to make a PDF accessible, or check a PDF free to see your document's heading outline.
Related
- Bookmarks – Failed
Acrobat’s “Bookmarks – Failed” means a document of 21 or more pages has no bookmarks. How to create them from headings in Acrobat Pro, Word and InDesign.
- List items and Lbl and LBody – Failed
Acrobat’s List items and Lbl and LBody rules fail when list tags are nested wrongly. The correct L, LI, Lbl and LBody structure and how to fix it.
- How to make a PDF accessible: a step-by-step guide
Make a PDF accessible from start to finish: fix the source file, export with tags, then check and fix tags, reading order, alt text, tables and forms.