Heading Hierarchy Auditor

Audit heading structure from a live URL or pasted HTML, then flag skipped levels, multiple h1 usage, style-only heading abuse, and title metadata drift

Paste HTML or provide a page URL to inspect heading semantics rather than visual reading order. The report surfaces skipped heading levels, multiple h1 nodes, likely style-only heading misuse, empty headings, and whether the main h1 drifts away from the document title or Open Graph title.

How to use it:

  • HTML Input: paste raw markup for deterministic checks
  • Page URL: fetch a live page when you want to inspect the published structure
  • Compare With Metadata Titles: checks the primary heading against <title> and og:title
  • Show Fix Suggestions: includes a suggested heading level or replacement strategy for each node

What the report highlights:

  • A visual hierarchy tree for h1-h6 nodes
  • Heatmap-like severity distribution across headings
  • Suggested replacement level for each heading node
  • Multiple h1 and skipped-level warnings
  • Likely style-only UI labels disguised as headings
  • Detachment between h1 and metadata titles

Example Results

1 examples

Audit a landing page with skipped heading levels and duplicate h1 tags

Review the outline tree, catch h1 duplication, and see which headings should become h2 or non-heading UI labels.

Heading hierarchy tree
View input parameters
{ "htmlInput": "<html><head><title>Acme Analytics Dashboard</title><meta property=\"og:title\" content=\"Acme Analytics Platform\" /></head><body><main><h1>Acme Analytics</h1><section><h3>Executive summary</h3><div class=\"card\"><a href=\"/demo\"><h2 class=\"btn-title\">BOOK DEMO</h2></a></div><h1>Pricing</h1><h4></h4></section></main></body></html>", "pageUrl": "", "compareWithMetadataTitles": true, "showFixSuggestions": true }

Key Facts

Category
Security & Validation
Input Types
textarea, text, checkbox
Output Type
html
Sample Coverage
4
API Ready
Yes

Overview

The Heading Hierarchy Auditor analyzes the semantic structure of your web pages by inspecting HTML markup or live URLs to identify skipped heading levels, duplicate H1 tags, style-only heading abuse, and discrepancies between your primary H1 and metadata titles.

When to Use

  • •When auditing a website's SEO and accessibility structure to ensure headings follow a logical, nested order.
  • •When preparing to launch a new landing page and verifying that UI labels are not incorrectly marked up as heading tags.
  • •When troubleshooting metadata drift where the main H1 tag does not match the page title or Open Graph title tags.

How It Works

  • •Paste your raw HTML markup into the input field or provide a live page URL to fetch the published document structure.
  • •Enable metadata comparison to cross-reference your primary H1 heading against the document title and Open Graph title tags.
  • •Run the audit to generate a visual hierarchy tree, highlighting skipped levels, duplicate H1s, and style-only heading elements alongside actionable fix suggestions.

Use Cases

Auditing landing page templates to ensure clean semantic structure before deploying them to production.
Verifying that blog posts and articles maintain a strict nested heading outline for optimal SEO and screen reader accessibility.
Identifying and correcting duplicate H1 tags and empty heading elements generated by visual page builders.

Examples

1. Auditing a Landing Page for SEO Compliance

SEO Specialist
Background
A marketing team launched a new landing page but noticed search engines are struggling to index the content structure correctly.
Problem
The page contains multiple H1 tags, skipped heading levels (H1 to H3), and a call-to-action button wrapped in an H2 tag.
How to Use
Paste the landing page HTML into the HTML Input field, check Compare With Metadata Titles and Show Fix Suggestions, then run the audit.
Outcome
The auditor flags the duplicate H1 tags, highlights the skipped H3 level, and suggests converting the button's H2 tag into a standard CSS-styled div.

2. Resolving Metadata Drift on a Blog Post

Content Editor
Background
An editor wants to ensure that a newly published article's main heading aligns with its search engine metadata.
Problem
The article's H1 heading has diverged from the title and og:title tags during multiple revisions.
How to Use
Enter the live article URL in the Page URL field, enable Compare With Metadata Titles, and run the audit.
Outcome
The tool generates a report showing the exact text mismatch between the H1 tag and the metadata titles, allowing the editor to align them for better SEO.

Try with Samples

html
Regex Named Capture Groups
Collection of regex patterns using named capture groups for extracting structured data from text. Named groups make patterns more readable and maintainable by assigning meaningful names to captured portions.
task extract
sample
Contentful Cloud-based CMS Samples
Comprehensive Contentful examples covering content modeling, API integration, webhooks, migrations, and frontend integration patterns
keywords content
sample
HTML with Images Samples
HTML source code samples with images for testing extraction
task extract
sample
JWT Samples
Comprehensive JWT examples from basic token structure to advanced security implementations
keywords structure
sample

Related Hubs

HTML Extraction, Cleanup, and Markdown/PDF Export Tools
Compare HTML cleanup, attribute extraction, image-source extraction, HTML-to-Markdown, and HTML-to-PDF tools in one hub for web content conversion workflows.
Web Accessibility Audit and Accessible Color Tools
Review WCAG issues, screen-reader order, contrast failures, color-vision risk, and accessible palette choices in one hub for website and UI accessibility workflows.
Audio Encoding and Format Conversion Tools
Compare audio format conversion, bitrate changes, sample-rate conversion, codec swaps, and export tools in one hub for delivery and archive workflows.
Image Format Conversion and Animated Export Tools
Compare image format converters for JPG, PNG, GIF, AVIF, WebP, TIFF, ICO, base64, and animation-friendly exports in one hub.

FAQ

What is heading hierarchy drift?

It occurs when the main H1 heading on a page differs significantly from the HTML title tag or Open Graph title metadata.

Why are skipped heading levels a problem?

Skipped levels, such as jumping from an H1 directly to an H3, disrupt the logical reading order for screen readers and search engine crawlers.

How does the tool detect style-only heading abuse?

It flags short, isolated headings or buttons wrapped in heading tags that function as UI labels rather than structural content headers.

Can I audit a page that is behind a login or on a local server?

Yes, by copying the raw HTML source code from your browser and pasting it directly into the HTML Input field.

Does the auditor suggest how to fix heading errors?

Yes, when the fix suggestions option is enabled, the report provides recommended heading levels or replacement strategies for each flagged node.

API Documentation

Request Endpoint

POST /en/api/tools/heading-hierarchy-auditor

Request Parameters

Parameter Name Type Required Description
htmlInput textarea No -
pageUrl text No -
compareWithMetadataTitles checkbox No -
showFixSuggestions checkbox No -

Response Format

{
  "result": "
Processed HTML content
",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
HTML: HTML

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-heading-hierarchy-auditor": {
      "name": "heading-hierarchy-auditor",
      "description": "Audit heading structure from a live URL or pasted HTML, then flag skipped levels, multiple h1 usage, style-only heading abuse, and title metadata drift",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=heading-hierarchy-auditor",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

If you encounter any issues, please contact us at [email protected]