Skip to content
Raptor home
Menu

Missing H1 heading

headings.h1_missing
Priority
Low
Severity
Warning

What we look for

These pages have no H1 heading (the main heading at the top of a page) with any text in it.

Why it matters

The main heading tells visitors and search engines what the page is about, and people using screen readers often jump to it first.

How to fix

Add one H1 heading near the top of each page that names its topic, in the CMS or page template. If the design shows the heading as a logo or image, make sure the H1 still holds real text.

Seen in a real crawl

From a crawl of the js-heavy fixture, a test site from Raptor’s fixture suite.

Low

4 pages have no main heading

  • /app/No H1 heading found
  • /app/dashboard/No H1 heading found
  • /app/settings/No H1 heading found
First 3 of 4 addressesPaths on http://127.0.0.1:8004raptor 0.3.0, 17 Oct 2026

Open this finding in that crawl’s report

Where you’ll see it

The id is stable, and every surface uses it, so it’s the thing to search for or hand to an agent.

Terminal
When it is one of the five findings under Fix first, raptor crawl prints the id under it.
Check: headings.h1_missing
crawl.json and the CSV
The crawl JSON names the finding by this id, and so do the CSV and raptor_query.
"check_id": "headings.h1_missing"
The HTML report
This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=headings.h1_missing
MCP
raptor_findings with this check_id returns the finding in full, with a fix brief ready to paste into a task. If it didn’t fire, it says why.
raptor_findings {
  "job_id": "...",
  "check_id": "headings.h1_missing"
}