Missing H1
medium On-page missing_h1
What we check
A crawled HTML page contains no <h1> in the served HTML. Sites that render text only in JavaScript can trigger this falsely; we do not run a browser.
Why it matters
The main heading tells readers and machines what the page is about. Screen-reader users jump to it first.
How to fix it
Give each page one visible H1 that states its topic, usually close to the title.
How to confirm the fix
Paste the page HTML into the heading outline checker. Glossary: H1.
In the API response
When this check fails, output.technical_issues contains an item with "id": "missing_h1", the affected URLs as evidence and the fix. If it is among the highest-priority problems it also appears in actions (as finding_id) and in plan.
Related checks
Run the full audit on your site. One call checks every item in the check reference and ranks the fixes.
Open the playground Endpoint details