How to fix: “Page should contain a level-one heading”
Page has no main heading, explained in plain English, with the exact fix and code you can copy.
- Scanner rule:
page-has-heading-one- Standard:
- Best practice (not a strict WCAG failure on its own)
What this error means
The H1 is the main heading of the page, the equivalent of a book title. Screen reader users often jump straight to it to confirm where they are. A page with no H1, for example a home page where the main headline is a styled paragraph or an image, gives them no starting point. This is a best practice rather than a strict WCAG failure.
Who it affects
Screen reader users, and people who skim pages by headings. Search engines also use the H1 to understand the page topic.
Where it usually hides
- Home pages where the big headline is a styled paragraph or text in an image
- Pages where the logo is the only large element at the top
- Page-builder layouts where the title is set as an H2 or lower
How to fix it
- Decide which text is the page's main headline. It should say what the page is about.
- Mark it up as an H1 (in your editor, set the block to 'Heading 1').
- Use only one H1 per page, then H2 and H3 for the sections below it.
- If the headline is inside an image, move the text out of the image, or add the same words as real text.
Before and after
Before
<p class="big-title">Gentle dentistry for the whole family</p>Looks like a headline, but it is not marked as one.
After
<h1 class="big-title">Gentle dentistry for the whole family</h1>Same appearance; now it is a real heading.
Common mistakes
- Making the logo the H1 on every page.
- Adding a hidden H1 that does not match what visitors see.
- Using several H1s to make text larger.
How to check your fix
- Re-run a scan to confirm the notice is gone.
- Use a headings browser extension and check that exactly one H1 is listed, and that it describes the page.
Is this on your site?
Run a free scan and see every page and element affected. No account needed.
Questions people ask
Should the H1 match the page title?
They are often similar, but they do not need to be identical. The title appears in the browser tab and search results, and the H1 appears on the page.
Keep reading
- Headings skip levels: Heading levels should only increase by one
- Page has no title: Documents must have <title> element to aid in navigation
- No main content area: Document should have one main landmark
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.