What You'll Learn
You'll learn how to control which types of changes in a live region are announced to screen reader users, so you don't overwhelm them with unnecessary updates.
What is aria-relevant?
When you mark an element as a live region (using aria-live), the browser watches for changes inside it. But not every change is worth announcing. The aria-relevant attribute lets you specify exactly which types of changes should trigger announcements.
Think of it like setting notification preferences on your phone—you don't want alerts for everything, just the updates that matter to you.
The Four Values
aria-relevant accepts a space-separated list of these keywords:
additions– Announce when new elements are added to the live regionremovals– Announce when elements are removed from the live regiontext– Announce when text content changesall– Announce all types of changes (equivalent toadditions removals text)
The default value is additions text, which covers most common scenarios.
When to Use It
Use aria-relevant when the default behavior announces too much or too little:
<!-- Only announce when items are added, not removed -->
<ul aria-live="polite" aria-relevant="additions">
<li>New notification</li>
</ul>
<!-- Announce both additions and removals -->
<div aria-live="polite" aria-relevant="additions removals">
Shopping cart: 3 items
</div>
For a stock ticker that only adds new prices, you'd use additions text. For a shopping cart where both adding and removing items matters, you'd use additions removals text.
Key Takeaway: Use aria-relevant to filter which changes—additions, removals, text changes, or all—trigger screen reader announcements in live regions, reducing notification fatigue for users.