Skip to content
UX Atlas
AccessibilityCraft conventionAdvanced

Status Messages and Live Regions

Telling assistive technology that something changed, when focus did not move to say so.

Definition

WCAG 4.1.3 requires that status messages can be presented to assistive technology without receiving focus. ARIA live regions are the mechanism: content inserted into them is announced automatically.

Craft convention. True because the industry converged on it. Breaking it costs familiarity, not correctness.

On this page
  1. Definition
  2. Politeness levels
  3. Implementation notes
  4. Sources
  5. Continue from here

Politeness levels

SettingBehaviourUse for
aria-live="polite"Announced at the next pauseSearch result counts, save confirmations, most updates.
aria-live="assertive"Interrupts immediatelyGenuine urgency only, such as a session about to expire.
role="status"Implicitly politeRoutine status updates.
role="alert"Implicitly assertiveErrors requiring immediate attention.

Implementation notes

  • The live region must exist in the DOM before the content changes. Adding the region and the message at the same time frequently announces nothing.
  • Keep messages short. Long announcements are hard to follow and cannot be re-read.
  • Do not use assertive for routine updates. It interrupts whatever the user was listening to.
  • Do not put live regions on content that changes constantly, such as a live counter.
  • Test with a real screen reader. Live region behaviour varies significantly between implementations.

Sources

Where a source establishes something narrower than the popular reading of it, the note says so.

Continue from here

Each link says what the connection is, so you can tell a principle from an alternative from a thing people mix this up with.

Applies when you are designing

A DashboardA Data TableA FormA Search ExperienceAn AI ProductAn Onboarding Flow

Why this works

The reasoning this entry rests on.

  • Selective AttentionPsychology

    A message outside the area of focus is routinely missed, which is why confirmation belongs where the action happened.

Relied on by

Entries that assume this is already in place.

Often used with

These usually appear in the same screen or the same decision.

Short definition

The one-paragraph version, for when that is all you need.

Related concept

Connected closely enough to change how you apply this.