Skip to content

Progress ​

Overview ​

A Progress Bar is used to indicate how much progress a user has made in a workflow, expressed as a percentage (%). It provides visual feedback during multi-step or multi-phase processes and helps users understand how far they are from completion.

Progress Bars communicate status, not activity. They should not be used as loading indicators or pre-loaders. For page or system loading feedback, use the EnLoading component instead.

Guidelines ​

Dos ​

  • Use Progress Bars for workflows with multiple steps or phases.
  • Display progress as a clear percentage of completion.
  • Update the Progress Bar as the user advances through the workflow.
  • Use Progress Bars to set expectations and reduce user uncertainty.
  • Ensure progress values are accurate and meaningful.

Don’ts ​

  • Don’t use Progress Bars as page loaders or spinners.
  • Don’t use Progress Bars for indeterminate or unknown durations.
  • Don’t display a Progress Bar if there is no measurable progress.
  • Don’t reset or regress progress unexpectedly without explanation.
  • Don’t rely on color alone to convey progress state.

Variants ​

VariantDescriptionExample Use
DefaultStandard progress indicationMulti-step forms, setup flows
SuccessIndicates completion or positive progressionFinal or completed steps
MiniThin meter with its count beside itA completion tally over a list or picker

Structure ​

Progress Bars should clearly represent completion from 0% to 100%.

  • Always define aria-valuemin, aria-valuemax, and aria-valuenow.
  • The width of the progress bar should directly reflect the percentage value.
  • Progress text may be visually displayed or screen-reader–only.

Accessibility ​

Use appropriate ARIA attributes to communicate progress to assistive technologies.

  • If visual text is hidden, include a screen-reader–only value.
  • Ensure sufficient contrast between the progress bar and its background.

Example with screen-reader text:

Mini meter ​

progress-mini is a thin meter with its count beside the bar instead of inside it — "1 of 1 assigned" under a group list, "3 of 5 classes grouped" over a class picker. At 6px the bar can't carry its own text, so the count sits next to it.

It wraps an ordinary .progress / .progress-bar pair, so the context variants (progress-bar-success, progress-bar-warning) work as usual. The track is 120px by default — override it with any width-*px utility.

Use it where the count is the point and the bar is supporting; use the full-size bar for a workflow the user is moving through.

EnLoading — Page and system loading indicators.

Progress Bar ​