Heading Hierarchy
A heading hierarchy uses heading levels to show how page sections fit together.
Another example
A medical guide uses one h1 for “Managing asthma.” It uses h2 for diagnosis and treatment, then h3 for types of medicine. A screen reader follows this outline even when a card title looks smaller.
Main parts
- 01Page heading
- 02Section heading
- 03Subsection heading
Use it when
Choose h1–h6 from the page structure. Style each heading's size separately.
Do not use it when
Do not choose h1–h6 only for font size. Do not skip a level just to get a preset style.
Name used in code
h1 through h6 selected by section depth Before you ship
Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states.
Outcome: Use Heading Hierarchy to solve this user need without losing the current context. User context: A medical guide uses one h1 for “Managing asthma.” It uses h2 for diagnosis and treatment, then h3 for types of medicine. A screen reader follows this outline even when a card title looks smaller. Recommended pattern: Heading Hierarchy. Why it fits: Choose h1–h6 from the page structure. Style each heading's size separately. Do not use it when: Do not choose h1–h6 only for font size. Do not skip a level just to get a preset style. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): The standard covers only the listed scope. It does not choose the visual style, product decision, or Vibulary example. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Heading Hierarchy. Definition: A heading hierarchy uses heading levels to show how page sections fit together. Release checks: Before release, check the page structure, keyboard access, visible focus, contrast, and zoom. Also check loading, empty, error, success, cancel, and reduced-motion states. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.