Course contentsShow
← Web Development
Lesson 1027 of 2,98218. Accessibility FundamentalsFree lesson

aria-atomic and aria-relevant

Fine-tuning live region announcements for optimal user experience with dynamic content.

Fine-Tuning Live Region Announcements

What You'll Learn

You'll learn how to control what parts of a live region get announced and how much context is provided when dynamic content changes.


The Challenge with Live Regions

You already know that aria-live makes dynamic content changes accessible to screen readers. But what happens when only part of a live region updates? Should the screen reader announce just the changed text, or the entire region? That's where aria-atomic and aria-relevant come in—they give you precise control over announcements.


aria-atomic: All or Part?

The aria-atomic attribute determines whether the entire live region should be announced or just the changed portion.

  • aria-atomic="false" (default): Only changed content is announced
  • aria-atomic="true": The entire region is announced, even if only part changed

Analogy: Imagine a news ticker. With atomic="false", you hear just the new headline. With atomic="true", you hear all headlines currently visible—providing full context.

<!-- Only announces "3 items" -->
<div role="status" aria-live="polite" aria-atomic="false">
  Cart: <span id="count">3</span> items
</div>

<!-- Announces "Cart: 3 items" (full context) -->
<div role="status" aria-live="polite" aria-atomic="true">
  Cart: <span id="count">3</span> items
</div>

aria-relevant: What Kind of Changes?

The aria-relevant attribute filters which types of changes trigger announcements.

Values (space-separated):

  • additions: Announce when nodes are added
  • removals: Announce when nodes are removed
  • text: Announce text content changes
  • all: Announce all changes (default equivalent: additions text)
<!-- Only announces additions, not removals -->
<ul role="log" aria-live="polite" aria-relevant="additions">
  <li>Message 1</li>
</ul>

Key Takeaway: Use aria-atomic="true" when users need full context around changes, and aria-relevant to filter which types of updates deserve announcements—creating a focused, non-intrusive experience with dynamic content.