h1.missing

What to change

A finding of this rule on a page carries the exact edits for that page: the markup it quotes, and what to write instead.

When it runs

Runs on every SEO audit: of a page, a crawl, a build directory or HTML. A warning is a problem that costs a page ranking, clicks or citations. Each finding takes 5 points off the page's score.

The severity here is the rule's usual one: a finding can be raised or lowered when the page gives a reason.

Run it, or skip it

Check a page for this rule alone, after a fix for instance:

npx @rivi-software/agentic-seo-check audit https://example.com --rule h1.missing

Or from an assistant, with the MCP tool seo_audit_page:

{
  "url": "https://example.com",
  "rules": [
    "h1.missing"
  ]
}

To leave it out of an audit, pass --disable h1.missing on the command, or disableRules: ["h1.missing"] to a tool.

• Infoh1.multipleThe page has more than one <h1>.
• Warningh1.emptyAn <h1> exists but contains no text.
• Infoh1.too-longThe <h1> is longer than the configured maximum (default 70 characters).
• Warningheadings.emptyHeading elements (h2-h6) with no text content.
• Infoheadings.skipped-levelHeading levels are skipped (for example an <h2> followed directly by an <h4>).