| name | heading-hierarchy |
| description | Use when structuring page content. Heading hierarchy (H1 → H2 → H3) helps both readers and search engines understand content.
|
Heading Hierarchy
One H1 per page. H2s for sections. H3s for subsections. Strict hierarchy. Skip-level headings (H1 → H3) break SEO + accessibility.
Hierarchy rules
- Exactly ONE H1 per page (the page title)
- H2s for major sections
- H3s for subsections within H2
- H4-H6 only if needed (rarely required)
- NEVER skip levels (H1 → H3)
- NEVER use H tags for visual styling (use CSS)
Keyword discipline in headings
- Primary keyword in H1
- Variations in H2s (related keywords)
- Long-tail in H3s
- Don't stuff (sounds robotic)
- Natural language always wins
Example:
H1: 'How AI Card Grading Works'
H2: 'Why Pre-Grade Before Submitting?'
H3: 'The Cost of PSA Rejection'
H2: 'How CardPrepAI Grades'
H3: 'Four Grading Axes'
Accessibility consideration
Screen readers navigate by heading hierarchy. Skipping H1→H3 confuses screen readers. Test with VoiceOver/NVDA: tab through headings, verify logical flow.
Where this fits in the X3 empire
Heading hierarchy enforced on every CardPrepAI page.