alert-circle An exclamation point inside of a circle. alert-triangle An exclamation point inside of a triangle shape. arrow-down-left An arrow pointing down and to the left. arrow-down-right An arrow pointing down and to the right. arrow-down An arrow pointing down. arrow-left An arrow pointing left. arrow-right-thick A thick arrow pointing right arrow-right An arrow pointing right. arrow-up-left An arrow pointing up and to the left. arrow-up-right-thick A thick arrow pointing up and to the right arrow-up-right An arrow pointing up and to the right. arrow-up-thick A thick arrow pointing up arrow-up An arrow pointing up. award A award bell A bell. calendar A calendar icon. camera-off A camera that is deactivated. camera A camera. check-circle A checkmark in a circle. checkmark A checkmark. chevron-down A chevron arrow pointing down. chevron-up A chevron arrow pointing up. chevron A chevron arrow pointing down. chevron A chevron arrow pointing down. chrome Chrome browser logo. close-circle An x in a circle. close A x shape. door A car door. edge Edge browser logo. ellipses An ellipses shape. engine A car engine. envelope A closed envelope. explorer Internet explorer logo. eye-off An eye that is deactivated. eye An eye. facebook Facebook logo. file-text A piece of paper with lines on it. file A blank piece of paper. firefox Firefox browser logo icon-flame A flame. fwd A car drivetrain. gear A gear with multiple teeth. grid A 2x2 grid. heart An empty heart. height-width Arrows indicating height and width measurement. home A home icon. info THe letter i in a circle. instagram Instagram logo. link A chain link. linkedin Linkedin logo. map-marker A map marker pin. maximize Four corners containing a plus sign. menu Three lines signifying a menu. message-circle A speech bubble. minus A minus dash. mpg A car dashboard gauge. opera Opera browser logo. pause A pause symbol. pencil A pencil. phone A phone handset. pinteest-disc Pinterest logo in a disc. pinterest Pinterest logo. play A play button. plus A plus symbol. safari Safari browser logo. search A magnifying glass. seat A car seat. shield A shield sliders A group of control sliders. square A square with rounded corners star A star. tag A shopping tag. thumbs-down A hand with the thumb pointing down. thumbs-up A hand with the thumb pointing up. trash A trash can. trophy A trophy. truck A truck icon. twitter Twitter logo. user-circle An outline of a person in a circle. user An outline of a person. video A video camera. youtube Youtube logo. zoom-in A magnifying glass with a plus in the center
Spark logo Spark Design System
Accessibility

Sequential headings

Heading tags (h1, h2, etc.) appear in descending, sequential order within the web page/DOM tree.

Back to the a11y checklist

Why it matters

Web pages often have sections of information separated by visual headings to communicate the organization of the content on the page. To make these work for web browsers, plug-ins, and assistive technologies, the headings need to be marked up. That way people can navigate from heading to heading, use the headings to understand the overall organization of the page content and the purpose of each section — including people who cannot use a mouse and use only the keyboard, or screen readers.

WCAG 2.0 reference: 2.4.10 Section Headings

Code example

<div class="page">
    <h1>Page Header</h1>  

    <div class="child1">
      <h2>Child 1 Header</h2>

      <div class="grandchild1">
        <h3>Grandchild 1 Header</h3>
      </div>
    </div>

    <div class="child2">
      <h2>Child 2 Header</h2>
    </div>
</div>
Don’t
  • There should only be one h1.
  • An h4 element should not appear on a page before an h3 element.
  • Don’t jump from a h2 to a h4, skipping a h3 element. If heading levels are being skipped for a specific visual treatment, use CSS classes instead.

How to check for this

  1. The page has a heading. In almost all pages there should be at least one heading. Automated
  2. All text that looks like a heading is marked up as a heading. Manual
  3. All text that is marked up as a heading is really a conceptual section heading. Manual
  4. The heading hierarchy is meaningful. Ideally the page starts with an “h1” — which is usually similar to the page title — and does not skip levels; however, these are not absolute requirements. Manual

Collaborators

  • Designers

Resources