Heading hierarchy
Headings should step down one level at a time. Skipping from h2 to h4 breaks the outline screen readers and search engines both rely on.
What it is
Heading hierarchy is whether a page's <h1> through <h6> tags step down one level at a time — an <h2> can be followed by another <h2> or an <h3>, but not by an <h4> with no <h3> in between. This check reads the sequence of heading tags in the order they appear in the HTML.
It's independent of the separate missing-H1 and multiple-H1 checks: a page can have exactly one H1 and still skip a level further down the outline.
Why it matters
Screen reader users commonly navigate a page by jumping between headings rather than reading linearly, and a skipped level makes that outline misleading — landing on an H4 with no H3 context reads as a subsection of nothing.
It's a low-severity, easy-to-audit signal rather than a functional break, which is exactly why it's worth fixing while a codebase is small: an inconsistent heading structure tends to compound as more sections get added by more people.
How to fix it
with a reference doc<h1>Page title</h1>
<h2>Section</h2>
<h3>Subsection</h3>
<h2>Next section</h2>Related checks
3This is one of the 75 checks the scanner runs. See what we check for the full list, every severity weight, and how the score is computed from them.