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.

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

  • Free in browserUse Heading Structure Analyzer here — no account required.
  • REST APICall from your server with X-Api-Key.
  • MCP for agentsConnect Cursor or Claude to ToolYour MCP with the same key.
  • 1. Get an API keySign in and open Dashboard → API Keys (works for REST and MCP).
  • 2. Call or connectUse the REST API from your server, or paste the MCP URL into your agent config.
  • 3. Same qualityOutput matches the free web tool across all three surfaces.

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?

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.

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

Are empty headings flagged?

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

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 does the report include?

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

What are the key features of Heading Structure Analyzer?

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.

Skip detection

Counts and samples level jumps greater than one.

Empty heading catch

Lists indexes of blank heading elements.

Per-level counts

Shows h1–h6 frequencies for quick structure review.

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.

Run heading analysis

Build the outline and score hierarchy issues.

Repair in document order

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

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.

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.

Limitations

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

Where do you browse more digital tools tools?

Related tools

Popular in Digital Tools