ScrepyDocs

H1 and Heading Structure Audit

Review missing, repeated, empty, and out-of-order headings in Screpy without applying rigid SEO rules to every page.

Headings organize visible content for readers and assistive technology. Screpy includes Missing H1, Multiple H1, Duplicate H1, Missing H2, Empty Headings, and Heading Jumps filters.

Understand each signal

  • Missing H1: no first-level heading was found.
  • Multiple H1: the page contains more than one H1.
  • Duplicate H1: separate crawled pages use the same H1 text.
  • Missing H2: no second-level heading was found.
  • Empty Headings: a heading element contains no meaningful text.
  • Heading Jumps: the hierarchy skips a level, such as H2 directly to H4.

These checks reveal structural patterns, not automatic ranking penalties. A short page may not need an H2. HTML permits multiple H1 elements, but one clear primary heading is often easier to maintain and understand. Duplicate H1 text can be valid when URL variants are intentionally consolidated, but distinct pages usually need distinct visible identities.

<h1>Technical SEO Audit</h1>
<h2>Check crawl access</h2>
<h3>Review robots.txt</h3>

Analyze heading findings

  1. View the rendered page, not only source markup.
  2. Identify the visible primary heading and compare it with page purpose and title.
  3. Inspect whether styling components misuse heading elements.
  4. Group repeated findings by template.
  5. Check whether empty headings come from optional CMS fields or hidden interface components.
  6. Read the outline in order and ask whether sections remain understandable without their visual styling.

Do not choose heading levels for font size. Use CSS for appearance and heading levels for hierarchy. Do not add a meaningless H2 only to clear the Missing H2 filter.

Fix the structure

Give the page one obvious main heading, nest subsections logically, remove empty elements, and correct reusable components that create invalid patterns. Distinguish related pages with headings that describe their actual content. Preserve wording that works for users instead of forcing exact-match keywords.

Example decision

Every article has an empty H2 because a subtitle component renders even when its CMS field is blank. Fix the component once. A compact contact page has one descriptive H1 and no subsections; leave it without an H2.

Verify the change

Inspect representative pages with styles and JavaScript enabled, test keyboard and assistive navigation where relevant, then run another crawl. Confirm the affected template no longer produces empty or misleading hierarchy while valid concise pages remain unchanged.

Use headings to reveal information structure

Headings help readers scan and understand sections. They are not a checklist where adding more H2 elements automatically improves SEO. The structure should reflect how ideas relate on the page.

A clear page usually has one primary heading for its main topic, followed by descriptive subheadings. Multiple H1 elements can be valid in HTML, but inconsistent templates often create confusing page structure. Review visual hierarchy and semantic hierarchy together.

Diagnose common patterns

  • Missing H1: confirm the main title is not rendered as a styled div or loaded only after interaction.
  • Multiple H1: identify whether navigation, logos, modals, or repeated cards are using H1 incorrectly.
  • Empty Heading: inspect icon components, hidden responsive elements, and CMS placeholders.
  • Heading Jump: decide whether a skipped level reflects a true nested structure or only visual styling.
  • Duplicate headings: distinguish useful repeated labels from boilerplate that hides the page's unique sections.

Do not change heading levels only to make text smaller or larger; use CSS for presentation.

Interpreting count changes

A template fix can reduce thousands of heading issues in one crawl. If Missing H1 falls but Empty Heading rises, the implementation may have created placeholder elements. If Heading Jump increases after a redesign, compare the DOM order with the visual layout.

Test representative articles, products, categories, empty states, and mobile variants. The W3C explains heading organization in its page structure guidance. Screpy identifies patterns; a human review confirms whether the outline serves the content.

Return to the Pages overview to compare heading findings across templates. MDN's HTML heading reference documents heading semantics and accessibility behavior.

On this page