How to add headings

Headings create an outline

Use headings for section structure, not simply to make text large. Readers and screen-reader users scan them to understand a page.

<h1>Beginner gardening</h1>
<h2>Choosing a location</h2>
<h3>Sunlight</h3>
<h3>Drainage</h3>
<h2>Planting seeds</h2>

Choose levels by nesting

  • Use a clear page-level h1
  • Use h2 for major sections and h3 for their subsections
  • Do not choose a level for its default font size
  • Avoid skipping levels when it would obscure the hierarchy

Write useful headings

Make each heading concise and descriptive. Text such as “Payment options” communicates more than “More information,” including when headings are listed without surrounding content.

Style separately

Use CSS to change size, weight, spacing, or color. Do not replace heading elements with bold paragraphs, because visual styling alone provides no heading semantics.