GitHub Add to your assistant
Menu

headings.empty

WarningSEO audit

Heading elements (h2-h6) with no text content.

What to change

Remove empty heading tags or fill them with text. Empty headings confuse outline parsers and screen readers.

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

Or from an assistant, with the MCP tool seo_audit_page:

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

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

All 6 rules