Notice: This is a work in progress. Please submit feedback or suggestions.

aria-level attribute (aria)

Screen reader support level: supported with 1 unknown result

Voice Control support level: unknown

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 2 years ago to 2 years ago. Detailed dates and version information can be found in associated tests.


What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the presence and value of the aria-level attributesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
Not applicable

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 applied to: heading rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported