Skip to content

Alert - Skipped heading level

  • WAVE Category: Alert
  • WAVE Alert: Skipped heading level

Page Content Status

  • WAVE Error guidance text
  • Example of a DOM Snippet Generated From WAVE Tool
  • Project Team Error guidance
    • Project Team Page Details
    • Project Team Issue and PR details
    • Project Team Solution
  • Credits/Authors

WAVE Error guidance

WAVE Tool's Reference material on Skipped heading level may not specifically address your problem. We provide it here for optional reading.

Click to see WAVE Tool Reference

This content added 2026-02-26. Check for updated guidance at: https://wave.webaim.org/api/docs?format=html#heading_skipped

WAVE Category

Alerts

WAVE Error

Skipped heading level

What It Means

A heading level is skipped.

Why It Matters

Headings provide document structure and facilitate keyboard navigation by users of assistive technology. These users may be confused or experience difficulty navigating when heading levels are skipped.

What To Do

Restructure the document headings to ensure that heading levels are not skipped.

The Algorithm... in English

A heading level is skipped (e.g., an <h1> is followed by an <h3>, with no intermediate <h2>). Note that an <h1> is not required to be the first heading within the document.

Standards and Guidelines

Example of a DOM Snippet Generated From WAVE Tool

[HTML snippet showing the problematic code structure that WAVE detected]

Project Team Error guidance

The following material covers how the Project Team has provided a solution to the Skippped heading level WAVE alert.

Project Page Details 1

  • Project Page name: Privacy Policy
  • Project Dev URL: http://tdm-dev.azurewebsites.net/privacypolicy
  • Requires sign in: FALSE
    • Required User Role: Visitor
    • Can access page directly from URL: TRUE
    • Accepts URL parameters: FALSE

Project Team Issue and PR details 1

  • Related GitHub Issue(s):
    • https://github.com/hackforla/tdm-calculator/issues/2716
  • Related Pull Request(s):
    • PR: https://github.com/hackforla/tdm-calculator/pull/2760
  • React Component(s)
    • [INSERT PATH: e.g. path/to/Component.jsx]

Project Page Details 2

  • Project Page name: Forgot Password
  • Project Dev URL: https://tdm-dev.azurewebsites.net/forgotpassword
  • Requires sign in: FALSE
    • Required User Role: All Users
    • Can access page directly from URL: TRUE
    • Accepts URL parameters: FALSE

Project Team Issue and PR details 2

  • Related GitHub Issue(s):
    • https://github.com/hackforla/tdm-calculator/issues/2701
  • Related Pull Request(s):
  • https://github.com/hackforla/tdm-calculator/pull/2779
  • React Component(s)
  • [INSERT PATH: e.g. path/to/Component.jsx]

Project Page Details 3

  • Project Page name: Manage Submissions
  • Project Dev URL: https://tdm-dev.azurewebsites.net/managesubmissions
  • Requires sign in: TRUE
    • Required User Role: Admin
    • Can access page directly from URL: FALSE
    • Accepts URL parameters: FALSE

Project Team Issue and PR details 3

  • Related GitHub Issue(s):
    • https://github.com/hackforla/tdm-calculator/issues/2705
  • Related Pull Request(s):
    • https://github.com/hackforla/tdm-calculator/pull/2799
  • React Component(s)
    • [INSERT PATH: e.g. path/to/Component.jsx]

Project Team Solution

What is the specific problem that was occurring?

[INSERT CONTENT]

What is the proposed solution to this problem?

[INSERT CONTENT]

Step-By-Step Guide

Click to see step-by-step guide

[ADD DETAILED INSTRUCTIONS HERE]

Other Technical Details

Click to see other technical details

[INSERT OTHER DETAILS e.g. Prop References, Return Value ]

Code Snippet With Solution

Click to see code snippets

[INSERT PATH file/path/to/Snippet.jsx]

[Code example showing the fix/solution]

Why the Fix Works

[INSERT CONTENT]

Where this solution is applicable

  • [INSERT SCENARIO 1]
  • [INSERT SCENARIO 2]
  • [INSERT SCENARIO N]

Screenshots of WAVE Error

1. Descriptive Title for Screenshot Set 1

Description/text for image

[INSERT IMAGE HERE]

Description/text for image

[INSERT IMAGE HERE]

1. Descriptive Title for Screenshot Set 2

Descriptoin/text for image

[INSERT IMAGE HERE]

Credits/Authors

  • @experimentsinhonesty
  • @Rabia2219
  • [INCLUDE Contributor N]