Skip to content
Raptor home
Menu

Missing H2 heading

headings.h2_missing
Priority
Low
Severity
Info

What we look for

These pages have no H2 heading (a section heading one level under the main heading).

Why it matters

Section headings break a page into parts that visitors can scan and search engines can follow. Short pages, such as contact pages, may not need any.

How to fix

Add H2 headings to longer pages to mark their main sections, in the CMS or page template. Leave short pages without sections as they are.

Seen in a real crawl

From a crawl of Fernhollow Outdoor, a test site built for this site’s demo.

Low

1 page has no second-level headings

  • /waterproofs/ridge-trousers/No H2 headings found
Paths on http://127.0.0.1:8006raptor 0.3.0, 17 Oct 2026

Open this finding in that crawl’s report

It also fired on Millbrook Hardware and the js-heavy fixture.

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.h2_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.h2_missing"
The HTML report
This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=headings.h2_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.h2_missing"
}