Skip to content
We use cookies to improve the site and measure traffic. See our Cookie Policy. You can accept or reject non-essential cookies.
  • Free
  • No signup
  • Fast
  • Privacy-friendly

Back to Category

Heading Structure Analyzer

Build an H1–H6 outline tree, detect missing or multiple H1s, level skips, and empty headings.

Waiting for bot check… this usually takes a second.

What next?

Keep going with Heading Structure Analyzer

Finish this check in the browser, then pick the path that matches how you work — another related tool, REST for apps, or MCP for agents.

  1. 1. Related check

    After this result, run Meta tags analyzer for the next signal.

    Meta tags analyzer
  2. 2. Automate with API

    Same job from your server with X-Api-Key. Free tier includes 500 credits/month.

    Create free account
  3. 3. Hand off to an agent

    Connect MCP and run playbook seo-site-audit, then verify until pass.

    SEO agent

What is Heading Structure Analyzer?

Messy heading hierarchies make pages hard to scan and harder for assistive tech to outline. Multiple H1s, H2→H4 skips, and empty heading tags are common in page builders. Content-optimization tools may count skips; this page returns the full ordered outline.

The Heading Structure Analyzer walks H1–H6 in document order, builds an outline with skip flags, scores hierarchy health, and returns findings with evidence indexes. Static HTML only — no LLM rewrite of headings.

Use it on pillar pages, after editor redesigns, and when accessibility audits flag heading order.

What are common questions about Heading Structure Analyzer?

Are empty headings flagged?

Yes. Empty h* elements create outline noise and weak accessibility trees.

What problem does heading analysis solve?

It exposes broken outline order — missing/multiple H1s, level skips, and empty headings — with a full tree you can edit against.

What is a heading level skip?

A skip is when the next heading jumps more than one level (for example H2 to H4), breaking outline nesting.

How is this deeper than content optimization?

Content optimization scores length and skips. This tool returns the complete outline sequence for hierarchy repair.

How many H1s should a page have?

Keep one H1 for the primary topic. Extra H1s are high-severity findings here.

What does the report include?

Outline nodes (level, text, skip flags), counts per level, findings, and scoring formulas.

Who needs outline reports?

Content designers, SEO editors, and a11y reviewers on long guides and template-driven sites.

Does JS-injected heading content appear?

No — only first-HTML heading tags. Client-rendered shells need server-rendered headings for crawl stability.

What are the key features of Heading Structure Analyzer?

Empty heading catch

Lists indexes of blank heading elements.

Full outline tree

Ordered H1–H6 list with text, emptiness, and skip-from-previous flags.

H1 health checks

Flags zero or multiple H1 headings with samples.

Per-level counts

Shows h1–h6 frequencies for quick structure review.

Skip detection

Counts and samples level jumps greater than one.

Deterministic scoring

Documents penalties for H1 issues, skips, and empty tags.

How do you use Heading Structure Analyzer?

Enter the page URL

Paste a content page — guides and category templates are ideal.

Repair in document order

Fix H1 count first, then skips, then empty tags in the CMS.

Run heading analysis

Build the outline and score hierarchy issues.

Use cases: pillars, builders, and accessibility QA

Pillar refresh — Rebuild H2/H3 to match the intended topic map before expanding word count.

Page builders — Elementor/Webflow sections often emit empty or skipped headings; catch them before launch.

A11y reviews — Export the outline evidence for remediation tickets.

Pair with Content Optimization for Flesch and length after structure is clean.

Why outline order is an SEO and a11y issue

Headings are the document’s table of contents. Screen readers use them to jump sections. Crawlers use them as topical boundaries. Skipping levels or repeating H1s muddies which section is primary.

Limitations

HTML heading tags only. ARIA roles that fake headings and JS-injected nodes after hydration are out of scope.

Free · API · MCPToolYour platform

Use Heading Structure Analyzer three ways

The free Heading Structure Analyzer on this page works in your browser. The same workflow is available via REST API for apps and via the remote MCP server for Cursor, Claude, and other agents — one API key, one plan, one quota. This tool is part of the seo-apis module under Digital Tools.

Agents close the full job with run_playbook seo-site-audit, then verify until pass — see SEO agent.

  1. 1Create a free accountGet an API key for REST and MCP — 500 credits/month on the free tier.
  2. 2Connect or callPaste the MCP URL into Cursor/Claude, or call REST with X-Api-Key.
  3. 3Same key & creditsBrowser smoke-checks stay free; API-backed runs share one monthly credit quota.