MDN contributors 2026 MDN Web Docs

ARIA: aria-roledescription and aria-live attributes (MDN Web Docs)

Two MDN reference pages on ARIA attributes: aria-roledescription, which gives an element a custom role name for assistive technology, and aria-live, which tells assistive technology to announce changes to part of a page.

License: CC BY-SA 2.5+ (Mozilla Contributors), the same basis as the other MDN sources such as Cognitive accessibility (MDN Web Docs).

Key points

  • aria-roledescription:
    • Defines a human-readable, author-localized description of an element’s role, which screen readers announce in place of the standard role name.
    • Use it only to clarify the purpose of non-interactive container roles such as group or region, or to give a widget a more specific description. People rely on known role names to understand how to interact with an element, so overriding one can do harm, and MDN advises avoiding the attribute where possible.
    • It changes only what’s announced, not behavior: a region with a custom role description is still navigated as a region.
    • The value must be non-empty and should be translated when the page is localized. The element must have a valid role.
    • Example: a container with role="article" and aria-roledescription="slide", labeled by its heading, is announced as “Quarterly Report, slide” rather than “Quarterly Report, article.”
  • aria-live:
    • Marks an element as a live region. When its content changes, assistive technology announces the change without moving focus. Screen readers present one part of the page at a time, so without a live region, users may miss updates elsewhere.
    • A common technique is an empty live region that’s filled with a brief announcement when something updates.
    • polite announces at the next graceful opportunity, without interrupting the current task. assertive interrupts immediately and should be kept for imperative, time-sensitive updates. off, the default, announces nothing unless the user is focused on the region.
    • For content that updates continually, such as news crawlers or stock tickers, use off unless the updates are the page’s main function, so users aren’t told about every change.

Cited In

Patterns

Created Updated