GitHub Add to your assistant
Menu

h1.empty

WarningSEO audit

An <h1> exists but contains no text.

What to change

Put the page heading text inside the <h1>. If it wraps only an image, give the image descriptive alt text.

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.empty

Or from an assistant, with the MCP tool seo_audit_page:

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

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

All 6 rules