aria-atomic for Complete Updates
You'll learn how to control whether a screen reader announces only the changed part of a live region or the entire region's content.
The Problem with Partial Updates
When dynamic content updates on your page (like a notification banner or status message), screen readers can announce just the changed text or the entire region. By default, they announce only what changed—but sometimes that change doesn't make sense without context.
Imagine a timer displaying "5 minutes remaining." When it updates to "4 minutes remaining," hearing just "4" leaves users confused. They need the full phrase.
What aria-atomic Does
The aria-atomic attribute tells screen readers whether to announce the complete live region content or just the changed portion.
aria-atomic="false"(default): Announce only what changedaria-atomic="true": Announce the entire live region
When to Use Each Value
Use aria-atomic="true" when:
- Context is needed to understand the update (counters, status messages)
- Multiple related pieces of information update together
- The changed text alone is meaningless
Use aria-atomic="false" when:
- Only the new information matters (chat messages, news feeds)
- Each update is independent
Example Structure
For a cart total that updates:
<div role="status" aria-live="polite" aria-atomic="true">
Cart total: $45.00
</div>
When the price changes to 52.00" instead of just "$52.00".
For a news feed where each item is independent:
<div role="log" aria-live="polite" aria-atomic="false">
<p>New article posted</p>
</div>
Key Takeaway: Use aria-atomic="true" when users need the full context to understand an update, and aria-atomic="false" when only the new information matters.