Course contentsShow
← Web Development
Lesson 1113 of 2,98220. Screen Readers and Assistive TechnologyFree lesson

aria-atomic for Complete Updates

Controlling whether the entire live region or only changed content is announced using aria-atomic.

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 changed
  • aria-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,thescreenreaderannounces"Carttotal:52.00, the screen reader announces "Cart total: 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.