Skip to main content
sus.botdocs
  • SEO
  • AI
  • QA
  • Privacy
  • Accessibility
  • Security
  1. Docs
  2. SEO
  3. Headings
  4. The headings of the page do not form a clean outline

SEO finding

The headings of the page do not form a clean outline

SEO Warning Severity: Medium

Part of the audit Headings. Finding id: seo.headingStructure.

What it costs you

Search engines and screen readers use headings as the outline of the page. Gaps and empty headings make the page harder to understand and to move through.

What to do

Give the page one h1 that names its subject, and let the other headings follow in order without skipping a level.

What it checks

  • Page has no main heading
  • Main heading is blank
  • More than one main heading
  • Main heading repeats the page title
  • Heading levels skipped
  • Blank headings
  • Too many headings

How to fix it

Repair the outline in the template or the content

  1. Check the template_id: a problem on every page of one template is fixed in the template.
  2. Use exactly one h1 for the page subject. Change a logo or site name marked up as h1 to a plain element.
  3. Go down one level at a time: h2 under h1, h3 under h2.
  4. Remove headings without text. Use CSS for spacing and for large text that is not a heading.

How to check: Recrawl the page and run this rule again.

Thresholds

Thresholds for The headings of the page do not form a clean outline
NameDefaultMeaning
max_headings60A page with more headings than this is reported. Long reference pages may need a higher value.
  • All audits
  • About sus.bot
  • Open the app
  • Contact support