We respect your privacy.

We use strictly necessary cookies to keep you signed in and to protect against CSRF. With your permission we also use a small amount of first-party analytics to improve the product. We do not sell your data and we do not use third-party advertising trackers. See our cookie policy and privacy policy .

Crawlmind
← All learn topics

Rule page.heading.hierarchy-skip

Fix heading-level skips

page.heading.hierarchy-skip is a check in Crawlmind's site audit that grades low-impact issues of this kind. This page explains why the rule matters and the exact fix.

Impact: lowEffort: lowFixable: 1-click

Why it matters

Heading order is a document outline. Jumping from H1 directly to H3 (skipping H2) breaks the outline that screen readers, AI assistants, and SERP "key moments" features all build from. The reader experience is unchanged because CSS sizes ignore semantic level: but every machine consumer treats the skip as a structure error.

The fix

```html
<!-- Before: H1 → H3 (skips H2) -->
<h1>Pricing</h1>
<h3>Pro plan</h3>

<!-- After: descend one level at a time -->
<h1>Pricing</h1>
<h2>Plans</h2>
<h3>Pro plan</h3>
```

If a section visually needs the smaller H3 size, keep the H2 semantic level and override the CSS for that one heading.

References