Documentation Menu↓
Issue Reports
How to Improve Headings Structure
Optimizing document structures and fixing heading hierarchies.
Difficulty:
|Intermediate
Est: 9 mins
|Updated July 2026
Overview
Headings (H1 to H6) structure your content logically for readers and search bots. A page should contain exactly one H1 tag acting as the primary title, with subsequent subheadings nesting in order (e.g. H2, then H3, then H2).
Severity Impact
Missing H1 tags are **Warnings** (-3 points). Multiple H1 tags are **Opportunities** (-1 point).
Detection Logic
Cheerio parses the page content and flags pages containing 0 or >1 H1 tags.
How to Fix
- Ensure each page has exactly one H1 tag. For blogs, this should wrap the article headline.
- Use H2 tags for main sections and H3 tags for subsections.
- Avoid using heading tags for styling (e.g. wrapping small footers in H3 tags).
Frequently Asked Questions
- Can I use multiple H1s on a single page?
While HTML5 supports multiple H1s (e.g., inside separate nested sections), search engines prefer a single H1 per page to represent the core theme.
Related Guides
Related Guides
Was this page helpful to your workflow?