Skip to content

Loader

A loader tells users that content, assets or UI elements are on their way, so a wait doesn’t read as a broken page.

  • CSS

Maintained by Platform

Usable — may still change

The loader gives feedback while content, assets or UI elements load. It combines a circular progress indicator with a label that says what is happening, and can offer an action such as retrying, cancelling or resetting. Once loading completes, it is removed and replaced by the loaded content.

Loading

  1. Loader
  2. Progress indicator
  3. Icon
  4. Label
  5. Action button

Use a loader when there is a wait for content, assets or UI elements to load. Once loading completes, remove it and show the loaded content in its place.

Type

Determinate shows measured progress from 0% to 100%. Indeterminate runs while the duration or completion percentage is unknown.

Icon

An optional decorative icon inside the progress indicator. It reinforces the loading state but carries no information.

Label

Says what is loading. Show it whenever possible, as it gives more meaningful feedback than the graphic alone. Hiding it is an edge case.

Action button

An optional main button below the loader, for retrying, cancelling or resetting when the user has to step in. It keeps the button’s own behaviour, states and content guidance.

On Lexus the progress indicator is drawn in the copper gradient. The gradient is a visual enhancement: the loading state has to remain understandable without it.

Describe what is loading whenever you can. Generic text is only for when there is no more context to give.

  • Preferred: “Loading your experience…”, “Loading search results…”, “Retrieving vehicle details…”
  • Acceptable: “Loading…”

Keep labels short and easy to scan, ideally on a single line, and avoid lengthy explanations.

When you show an action button, use the main button and follow its content guidance.