All checks / Content Understanding

Warning heading-hierarchy-broken

Heading levels descend in order

What this check means

Checks that heading levels on your homepage descend without skipping — an h2 does not jump straight to an h4.

Why it matters

Headings are the outline a machine uses to work out which text belongs to which topic. A skipped level breaks the nesting, so content ends up attributed to the wrong section — or to no section at all.

How we detect it

We read every heading on the homepage in document order and flag any jump of more than one level downward.

How to fix it

Use the next level down rather than choosing a heading for its size, and style it with CSS instead.

Check whether this applies to your site.

Run an AI audit

Other Content Understanding checks