Carbon Design System

Progress bar

Stable
Last updated Sep 30, 2026

A progress bar provides feedback on the status and duration of a process, helping users understand progress and expected wait times.

Progress bar

Color

Element

Property

Color token

Label

text-color

$text-primary

Helper text

text-color

$text-helper

Helper text: error

text-color

$text-error

Track

background

$border-subtle

Bar: active

background

$border-interactive

Bar: success

background

$support-success

Icon: success

fill

$support-success

Bar: error

background

$support-error

Icon: error

fill

$support-error

Progress bar statuses

Progress bar statuses

Typography

Element

Font-size (px/rem)

Font-weight

Type token

Label

14px / 0.875rem

Regular / 400

$body-compact-01

Helper text

12px / 0.75rem

Regular / 400

$helper-text-01

Structure

Depending on the use case, the progress bar can use three text alignment options: default, inline, or indented. The width of a progress bar can be customized appropriately for its context. The minimum width of a progress bar is 48px. Keep its width to a maximum of six columns when possible.

Element

Property

px / rem

Spacing token

Label (top aligned)

padding-bottom

8 / 0.5

$spacing-03

Helper text

padding-top

8 / 0.5

$spacing-03

Label (left aligned)

padding-right

16 / 1

$spacing-05

Structure and spacing measurements for the progress bar.

Structure and spacing measurements the progress bar | px / rem

Structure and spacing measurements for the progress bar with an icon.

Structure and spacing measurements for the progress bar with an icon.

Sizes

There are two sizes for the progress bar height: big and small.

Size

Height px / rem

Big

8 / 0.5

Small

4 / 0.25

Progress bar sizes

Feedback

Help us improve by providing feedback, asking questions, requesting features, or leaving any other comments on GitHub.