ARIA attribute indicating dynamic content that should be announced by assistive technologies. Values: off, polite, assertive.
aria-live is an ARIA property that tells screen readers when and how to announce dynamic content changes. It's essential for modern web applications where content updates without full page reloads – think search results, form validation, chat messages, or status updates.
Without aria-live, screen reader users miss important information that appears dynamically. They might submit a form and never know there was an error, or wait for search results that already loaded. aria-live bridges this gap by ensuring that dynamic content changes are announced appropriately.
The property has three values that control announcement timing and priority: off (default), polite, and assertive. Each serves different use cases and user experience needs.
aria-live="polite" (Most Common): - Announces changes when the user finishes their current activity - Used for non-urgent updates like search results or form validation - Doesn't interrupt the user's current task
```html
aria-live="assertive" (Urgent Updates): - Announces changes immediately, interrupting current activity - Used for critical errors or important status changes - Should be used sparingly to avoid overwhelming users
```html
aria-live="off" (Default): - No announcements for dynamic changes - Used when content changes are purely visual or not important for screen reader users
Form Validation Messages: ```html
Search Results: ```html
Chat Messages: ```html
Progress Updates: ```html
Best Practices: - Use polite for most updates, assertive only for critical information - Provide context with aria-label or aria-labelledby - Test with actual screen readers to ensure announcements work as expected - Keep messages concise and meaningful - Avoid updating aria-live regions too frequently
Common Pitfalls: - Using assertive too often, overwhelming users with interruptions - Not providing context for what's being announced - Updating content too rapidly, causing announcement conflicts - Using aria-live on content that doesn't actually change - Not testing with real screen readers
Performance Considerations: - aria-live regions can impact performance if updated too frequently - Consider debouncing updates to avoid excessive announcements - Remove aria-live when content becomes static
WebAbility automatically manages aria-live regions for dynamic content, ensuring that important updates are announced appropriately without overwhelming screen reader users.
Join over 1 million websites using WebAbility to ensure digital accessibility compliance and provide equal access to all users.
The computed name exposed to assistive technologies for an element, derived from label, aria-label, aria-labelledby, or text content.
Supplemental help text associated with an element, often via aria-describedby, that provides additional guidance beyond the accessible name.
An area of the page that notifies assistive technologies about dynamic updates. Use sparingly with polite or assertive announcements.
Text associated with an input that communicates its purpose. Implement with <label for> or ARIA labelling.
Page sections identified by semantic elements or ARIA roles (main, navigation, complementary, banner, contentinfo) for quick navigation.
This glossary is continuously improved and maintained by WebAbility to advance accessible design and development.Contact us to suggest improvements or report issues.