missing H1
Pages without an H1 tag lack a primary heading for search engines and users
What it is
crawler.sh flags a page as having a missing H1 when no <h1> tag is found in the HTML body. This is check #17 in the SEO analysis.
Why it matters for SEO
The <h1> tag is the primary heading of a page and signals its main topic to search engines. It directly affects:
- Relevance signals - Search engines use the H1 as a strong indicator of what the page is about.
- Content structure - The H1 anchors the heading hierarchy (H1 → H2 → H3), helping crawlers understand content organization.
- User experience - Visitors rely on the H1 to confirm they’ve landed on the right page.
- Accessibility - Screen readers use headings to navigate page content. A missing H1 makes navigation harder.
Why it matters for AEO
AI answer engines (ChatGPT, Perplexity, Google AI Overviews) use headings to parse page structure and extract relevant answers. A page without an H1 is harder for AI systems to understand and less likely to be cited as a source. Clear headings help AI models identify the primary topic and pull accurate information.
How to fix it
Add a single, descriptive <h1> tag to each page:
<body> <h1>Your Primary Page Heading</h1> <!-- rest of content --></body>Guidelines:
- Every page should have exactly one H1
- The H1 should describe the page’s main topic
- Include the primary keyword naturally
- Keep it between 10 and 70 characters
What crawler.sh reports
In the CLI, missing H1 tags appear under the “Missing H1” section of crawler seo output. Each affected URL is listed. In the desktop app, they appear in the SEO Issues card.
Tip: Missing H1 is a high-priority issue. Every page should have a clear primary heading that tells users and search engines what the page is about.
