vocab.design

accessibility

Politeness level

also called aria-live polite (aria), assertive (aria), live region politeness (community), announcement queue (community)

The urgency setting on a live region: polite waits for a pause in speech, assertive interrupts whatever is being read.

aria-live takes three values and they are a queue policy, not a volume knob. off is the default: changes inside the element are not announced at all. polite puts the new text at the back of the queue, so the screen reader finishes the sentence it is speaking, finishes anything already waiting, and then reads it. assertive clears the queue and speaks immediately, abandoning the current utterance mid-word. Nothing about the visual design changes; the setting only decides where in a stream of speech the update lands. What a live region is, and how one is wired up, belongs to that entry.

Assertive is almost always the wrong answer, because interrupting means destroying: the sentence the reader was listening to is gone, and there is no way to ask for it back. That cost is worth paying only when acting late is worse than losing the sentence, which in practice means a session about to expire, a connection dropping mid-transaction, or a validation failure that has already blocked a submit the person just made. A saved draft, a finished upload, a filter that returned nine results: all of those are polite, because waiting two seconds costs nobody anything. The rule of thumb that survives review is to write polite by default and make anyone proposing assertive say out loud what the reader loses.

Two shorthands sit on top of the attribute. role="status" carries an implicit polite politeness, and role="alert" carries assertive plus an implicit aria-atomic="true", so the whole region is re-read rather than just the changed words. Reaching for the role instead of the attribute is usually better, since the role also tells assistive technology what kind of thing the region is, and a status message is the pattern most of these updates actually are.

The failure modes are queue failures. Several polite regions updated in the same tick pile up and are read one after another, so a page that announces every filter change announces four of them by the time the reader has stopped typing. An assertive region that fires repeatedly makes speech unusable, since each new message kills the one before it, including its own predecessor. And a region that is emptied and refilled in quick succession may be read twice or not at all, depending on the screen reader, which is why an announcer usually debounces and writes one final string rather than a running commentary.

Which word?

If you wantsay
choosing whether an update may interrupt speechpoliteness level
a partial update would be read out of contextatomic live region
a region updates in pieces and each piece speaksbusy state
something must be spoken without stealing focuslive region
arguing about how much detail a label should carryverbosity

Sources