← Components/primitives

ProgressBar

Carbon-spec linear progress indicator. Determinate (with explicit value) or indeterminate (animated stripe). Supports an inline label + helper text + status (active/finished/error).

primitivesstablea11y: untested2/3 coverageEdit on GitHub ↗
primitives-progressbar--defaultOpen all variants →

When to use

  • Long-running operation with a known percentage (file upload, batch export, training run).
  • Indeterminate variant for ops where percentage isn't available but visual reassurance is.

When not to use

  • Spinner-style indeterminate without bar shape → use `Loading` or `InlineLoading`.
  • Layout-shape placeholders → use `Skeleton`.
  • Multi-step sequential flows → use the ProgressIndicator pattern (steppers).