Page has exactly one H1

h1_count

Checks that the page has exactly one H1 heading.

What does this rule check?

The H1 heading defines the primary topic of the page. While HTML5 allows multiple H1s, SEO best practice is to have exactly one H1 per page that clearly states the main topic. This helps search engines understand page relevance.

Why is this important?

Zero H1s means search engines miss the main topic. Multiple H1s dilute the page's primary focus and send mixed signals about what the page is about.

How to fix

Ensure each page has exactly one <h1> tag with the main topic of the page. Convert additional H1s to H2s or lower.

Examples

<body>
  <h1>Welcome to Our Store</h1>
  <h1>Best Products</h1>
  <!-- Two H1s dilute the focus -->
</body>

<body>
  <h1>Best Running Shoes for Marathon Training</h1>
  <h2>Top Picks</h2>
  <h2>Buying Guide</h2>
</body>

Agent fix snippet

Copy this snippet and paste it into your AI coding agent to fix this issue automatically.

Find all <h1> tags on the page. Keep only one H1 for the main topic.
Convert extra H1 tags to <h2> or lower as appropriate for the content hierarchy.