Skip to main contentCarbon Design System

Progress indicator

The following page documents visual specifications such as color, typography, structure, and size.

Color

A progress indicator step may be complete, current, or not started. The following table describes the color tokens used for each of these states.

ElementPropertyColor token
Complete iconfill$interactive
Current iconfill$interactive
Not started iconfill$icon-primary
Active step linebackground-color$border-interactive
Inactive step linebackground-color$border-subtle *
Labeltext color$text-primary
Helper texttext color$text-secondary

* Denotes a contextual color token that will change values based on the layer it is placed on.

Examples of current, completed, and future steps for progress indicator

Examples of completed, current, and future steps for progress indicator

Interactive states

ElementPropertyColor token
Step: focusborder$focus
Label: hovertext color$link-primary-hover
Icon: errorfill$support-error
Icon: disabledfill$icon-disabled
Examples of focus, hover, error, and disabled states for progress indicator

Examples of focus, hover, error, and disabled states for progress indicator

Typography

Labels should be one to two words only, with a limit of 16 characters total per label. All labels should be set in sentence case.

ElementFont-size (px/rem)Font-weightType token
Label14 / 0.875Regular / 400$body-compact-01
Helper text12 / 0.75Regular / 400$label-01

Structure

All icons can be found in the icons library.

ElementPropertypx / remSpacing token
Stepmin-width128 / 8
Iconheight, width16 / 1
margin-top, margin-right16 / 1$spacing-05
Labelmargin-top16 / 1$spacing-05
Structure and spacing for progress indicator

Structure and spacing measurements for progress indicator | px / rem

Feedback

Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.