aria-live

Token

Turns a container into a live region so assistive technologies announce changes to its content without the user moving focus there. 'polite' waits for a natural pause, 'assertive' interrupts immediately, and 'off' disables announcements. Set it on the container before the content changes, since regions added and populated in the same moment are often missed.

aria-live="…"

Values

off (default): Updates are not announced.
polite: Updates are announced at the next graceful opportunity.
assertive: Updates are announced immediately, interrupting the user.

Used on

Any HTML element — aria-live is a global property.

Associated roles

Every ARIA role. As a global property, aria-live is supported on all roles.

Example

aria-live="…"

<div aria-live="polite">Changes saved.</div>

References

WAI-ARIA 1.2 specification
MDN Web Docs