H1 Tag SEO Rule

H1 Tag SEO Rule

Validate that every page has exactly one non-empty H1 tag with appropriate length for search optimization

What This Rule Checks

Validates that each page has exactly one H1 tag (configurable). Checks for missing, empty, too-short (under 10 chars), or too-long (over 70 chars) H1 tags.

Why It Matters for SEO & GEO

The H1 tag is the primary heading that tells search engines and users what the page is about. Multiple or missing H1 tags weaken the page's topical signal.

How to Fix

Add exactly one descriptive H1 tag per page. Keep it between 10-70 characters. Include your primary keyword. Ensure it accurately describes the page content.

Examples

Bad

<h1></h1>

Good

<h1>Complete Guide to On-Page SEO Optimization</h1>

How VibeLinter Checks H1 Tags

VibeLinter’s headings/h1 rule performs these checks on every page:

Existence — Errors when no H1 tag is found (when requireOne is enabled)
Count limit — Warns when multiple H1 tags exist (configurable via maxCount, default: 1)
Empty check — Errors on H1 tags with no text content
Minimum length — Warns when H1 text is shorter than 10 characters
Maximum length — Issues an info-level alert when H1 text exceeds 70 characters

Configuration

// vibelinter.config.cjs
module.exports = {
  rules: {
    'headings/h1': {
      enabled: true,
      severity: 'error',
      requireOne: true,
      maxCount: 1
    }
  }
}

SEO Impact

A properly configured H1 tag affects:

Page topic signal — The H1 is the strongest heading-level signal for what the page is about
Content hierarchy — Establishes the primary topic that subheadings should support
Accessibility — Screen readers use H1 to identify the main content area
GEO (Generative Engine Optimization) — AI models heavily weight H1 tags when determining page topics and generating summaries, making accurate H1s essential for AI search visibility