Skip to content
UX Atlas
ComponentCraft conventionFoundational

Alert and Inline Message

A persistent message tied to a context, which is where anything requiring action belongs.

Definition

An alert communicates a status or condition and stays until it is resolved or dismissed. Its persistence is what makes it suitable for information the user must act on.

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

On this page
  1. Definition
  2. Placement by scope
  3. Requirements
  4. Continue from here

Placement by scope

ScopePlacement
A single fieldDirectly below the field, associated with aria-describedby.
A form or sectionAt the top of that section, with links to the affected fields.
The whole pageBelow the header, above the content.
The whole accountA persistent bar, used very sparingly.

Requirements

  • Icon plus colour plus text. Colour alone fails WCAG 1.4.1.
  • State the problem and the next action, with a control where one applies.
  • role alert for messages requiring immediate attention; role status for routine updates.
  • Do not allow dismissal of an alert describing an unresolved blocking condition.
  • Keep the tone factual. The user is not at fault.

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

Principles behind this

The reasoning this solution is an application of.

Depends on

Get these right first, or this one will not hold.

Often used with

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

Commonly confused with

Close enough to be mixed up, different enough to matter.

  • ToastComponent

    An inline alert stays with the thing it describes. A toast disappears, so it cannot carry anything important.

Related concept

Connected closely enough to change how you apply this.