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-roledescription attribute (aria)

Screen Reader support level: partial (17/22)

On this page

About this feature

Defines a human-readable, author-localized description for the role of an element.

Age of results

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


Failing or partial results may be out of date. The oldest result is from 4 years ago. Consider running the associated tests and contributing results.


What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the value of the roledescription attribute as the rolesupportedsupportedpartial (1/2)supportedsupportedsupportedsupportedsupportednonenonesupported

Expectation: convey the value of the roledescription attribute as the role


A screen reader user needs to know the current value of the input.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the value of the roledescription attribute as the role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
aria-roledescription attribute with HTML button applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenonesupported
aria-roledescription attribute with HTML section applied to: section elementsupportedsupportednonesupportedsupportedsupportedsupportedsupportednonenonesupported