Skip to main content

Primary keyword appears in the page H1

ab-001679 · marketing-advanced-seo.content-optimization.keyword-in-h1
Severity: highactive

Why it matters

A generic H1 like Welcome tells Google nothing about the page's topic, and the search engine falls back to anchor text and body text to guess intent — usually wrong. For content-driven sites this directly suppresses rankings on the exact queries the page should win, and for templated pages sharing a layout-level H1 every URL competes against itself for the same phrase.

Severity rationale

High because the H1 is the second-strongest on-page signal after `<title>` and defects propagate across every page sharing the layout.

Remediation

Write a single descriptive H1 per page that matches the primary topic, and for templated routes pull the H1 from the same data source as the <title>. If the H1 lives in a shared layout today, move it into the route component so each page controls its own heading.

// app/products/page.tsx
<h1>Best SEO Tools for Small Business</h1>

Detection

  • ID: marketing-advanced-seo.content-optimization.keyword-in-h1

  • Severity: high

  • What to look for: Count all pages and enumerate whether each has exactly 1 H1 tag containing the primary keyword. Examine page components for their H1 content. Check whether the H1 and page title are semantically aligned (covering the same topic). Specifically fail on generic or placeholder H1 text: "Welcome", "Home", "Page Title", a blank H1, or all pages sharing the same H1 from a layout with no per-page override.

  • Pass criteria: H1 tags contain descriptive content terms. Dynamic H1s from post titles, product names, or category names pass. Hardcoded H1s are descriptive, not generic placeholders. At least 90% of indexable pages should have exactly 1 H1 with the primary keyword.

  • Fail criteria: Any static H1 is a generic placeholder. All pages share the same H1 from a layout with no per-page override.

  • Skip (N/A) when: No pages with statically determinable H1 content exist.

  • Cross-reference: For title keyword placement, see keyword-in-title. For heading quality, see heading-keyword-quality.

  • Detail on fail: "Generic or placeholder H1 detected. Example: homepage H1 is 'Welcome' with no descriptive content term. H1 should reflect the page's primary topic for search engines to understand content focus."

  • Remediation: The H1 is the strongest heading-level SEO signal on a page. It should describe what the page is about, using the same language your target audience uses to search for it. Replace generic H1s with descriptive ones that clearly state the page's primary topic. The H1 and title do not need to be identical, but they should cover the same subject area.

    // app/products/page.tsx — single keyword-optimized H1
    <h1>Best SEO Tools for Small Business</h1>
    

Taxons

History