What this check tests
For each crawled page (the homepage plus a sample of same-site pages) the audit lists every h1 to h6 element in the served HTML, in document order, wherever they sit in the page, including in the navigation, header and footer. A page is good when all three hold:
- It has at least one heading. A page with no headings is never good.
- It has exactly one
h1. Zero or two or more fails the page. An emptyh1still counts as an element. - Reading the headings in order, no heading is more than one level deeper than the one before it.
h1thenh3fails. Going up by any amount is fine, soh4thenh2passes. The first heading's level is not checked, so a page that opens with anh3is not penalised for that alone.
The score is good pages divided by all crawled pages, rounded. Pages without headings stay in the divisor.
- Pass: 80 or more.
- Partial: above 0 but under 80.
- Fail: 0.
Because it counts markup and not meaning, a page can pass with useless headings, and a page can fail on a layout choice. A common case is a theme that puts the site name in an h1 in the header and the page title in a second h1. Another is a footer that uses h4 headings straight after an h2. Headings that only exist to make text bigger count the same as real ones. The check also reads the HTML as served, so headings created in the browser by script are not seen.
Why it matters to agents
MDN states that heading information can be used by user agents to build a table of contents automatically. Any tool that reads the HTML can use the same outline to split a long page into sections and find the one it needs. A clean h1 gives the page one clear subject.
No official source cited here says that AI assistants or crawlers rank pages by heading order, so do not read this check as a ranking factor. It is a content-structure check with weight 0.5, the lowest tier in the category. The practical reason to pass is that a tool that reads the HTML can follow the structure.
MDN's guidance matches this check on two points: do not skip heading levels, and avoid several h1 elements on one page. It notes the HTML standard allows more than one h1, but calls that not a best practice. The check applies the stricter reading.
How to fix it
- Give each page one
h1that says what the page is about, ideally close to the<title>. - Use
h2for the main sections,h3for parts of those, and so on, without gaps. Choose the level for the structure and use CSSfont-sizefor the look. - In a theme or component library, check that the logo or site name in the header is not an
h1on inner pages. Apordivwith a link works. - Check that footer, sidebar and card titles do not jump. If the heading before a card title is an
h2, the card title can be anh2orh3, not anh4. If the design needs small text there, style apordivinstead of using a deeper heading. - Add at least one heading to pages that have none, such as landing pages built from images and styled text.
- View the source (not the inspector) to confirm the headings are in the HTML the server returns.
For related structure, see Semantic HTML elements, which checks for main, nav, article, section and aside, and Content accessible without JS.