How to fix: “Heading levels should only increase by one”
Headings skip levels, explained in plain English, with the exact fix and code you can copy.
- Scanner rule:
heading-order- Standard:
- Best practice (not a strict WCAG failure on its own)
What this error means
Headings work like an outline. The page has one main heading (H1), sections under it (H2), and sub-sections under those (H3). A heading that jumps from H2 to H4 leaves a gap in the outline. This is flagged as a best practice rather than a strict WCAG failure, but it makes the page harder to navigate, and it is closely related to WCAG's requirement that structure be available to assistive technology.
Who it affects
Screen reader users, who commonly jump from heading to heading to skim a page. Skipped levels make them wonder whether they missed a section.
Where it usually hides
- Headings chosen for their size instead of their meaning (an H4 used because it looks smaller)
- Sidebar and footer widgets that use H3 or H4 with no parent heading
- Page-builder blocks that default to a particular heading level
How to fix it
- List your headings in order (a browser extension such as 'HeadingsMap' shows them, or use the scan report).
- Make each heading exactly one level below its parent: H1, then H2, then H3.
- If a heading needs to look smaller, keep the correct level and change its size with CSS or the builder's font-size option.
- A heading may jump back up by any amount (an H4 followed by an H2 is fine). Only skipping downward is flagged.
Before and after
Before
<h1>Our dental services</h1>
<h4>Teeth whitening</h4>H1 straight to H4.
After
<h1>Our dental services</h1>
<h2>Teeth whitening</h2>Correct order. Use CSS if you want the H2 to look smaller.
Common mistakes
- Using headings purely for styling on text that is not a heading.
- Fixing the order but accidentally leaving two H1 headings on one page.
How to check your fix
- Re-run a scan to confirm the warning is gone.
- Read your headings from top to bottom as a plain outline. It should make sense on its own.
Is this on your site?
Run a free scan and see every page and element affected. No account needed.
Questions people ask
Is skipping a heading level a legal problem?
On its own it is a best-practice issue, not a WCAG failure. It still makes a page harder to use, and it is a quick fix, so it is worth doing.
Can I have more than one H1?
One H1 per page is the safe choice. It names the page, the way a book title does.
Keep reading
- Page has no main heading: Page should contain a level-one heading
- No main content area: Document should have one main landmark
- Page has no title: Documents must have <title> element to aid in navigation
Automated scans catch only part of what WCAG covers, and fixing a scan result is not a legal guarantee of compliance. Last reviewed November 16, 2026.