Using the aria-relevant attribute

The aria-relevant attribute is an optional value used to describe what types of changes have occurred to an aria-live region, and which are relevant and should be announced. Any change that is not relevant acts in the same manner it would if the aria-live attribute were set to off.

aria-relevant is commonly used when a web page contains content that may be updated while viewing the page.


A space-delimited list of one or more of the following values:

Additions of Element Nodes within the live region should be considered relevant.
Deletion of Nodes from the live region should be considered relevant.
Changes to the textual content of existing nodes should be considered relevant.
Equivalent to additions removals text.

aria-relevant="additions text" is the default value on a live region.

Additional resources