Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

aria-level attribute (aria)

Screen Reader support level: partial (15/22)

On this page

About this feature

Defines the hierarchical level of an element within a structure.

Age of results

Results across all tests for this feature range from 5 months ago to 5 years ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 5 months ago and 5 months ago.


What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the presence and value of the aria-level attributepartial (1/2)partial (1/2)partial (1/2)partial (1/2)partial (1/2)partial (1/2)supportedsupportedpartial (1/2)supportedsupported

Expectation: convey the presence and value of the aria-level attribute


The user needs to know that the element has a level and the value of that level.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA


  • When applied to a heading, the heading might be announced as something like "<name> heading level <level>"
Screen Reader support for 'MUST convey the presence and value of the aria-level attribute'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
HTML and ARIA headings test (level 6 and below) applied to: heading rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
ARIA headings greater than level 6 applied to: heading rolenonenonenonepartialpartialpartialsupportedsupportednonesupportedsupported