headings.skipped-level
Heading levels are skipped (for example an <h2> followed directly by an <h4>).
What to change
Use heading levels in order (h1 > h2 > h3) so the document outline reflects the content structure.
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. Info is a best practice: worth doing, rarely urgent, and --no-info leaves it out. Each finding takes 1 point 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.skipped-levelOr from an assistant, with the MCP tool seo_audit_page:
{
"url": "https://example.com",
"rules": [
"headings.skipped-level"
]
}To leave it out of an audit, pass --disable headings.skipped-level on the command, or disableRules: ["headings.skipped-level"] to a tool.