Progress Tracker

The Progress Tracker guides users through multi-step workflows, showing completed, current, and incomplete steps, helping them stay oriented across multiple screens.

Usage guidelines outline how the component should and shouldn’t be used in different user interface contexts.

When to use

  • Multi-screen forms or workflows (e.g. project setup)
  • Any task that benefits from structured, step-by-step guidance

When not to use

  • All steps are presented on a single page or screen (e.g. external feed creation)
  • The task is short enough that progress tracking adds unnecessary visual noise

Best practices

Do

Use brief Title Case step labels e.g. ‘Deployment Process’.

Don't

Hyperlink/show hover states for the ‘Complete’ and ‘Incomplete’ steps.

Do

Hyperlink/show a hover state for the ‘Current’ step when the tracker is shown on a page.

Don't

Hyperlink/show a hover state for the ‘Current’ step when the tracker is shown in a dialog.

Do

Show the dismiss button when the tracker is shown on a page.

Don't

Show the dismiss button when the tracker is shown in a dialog.

Caution

Progressively show steps based on a user's selections (e.g. a Version Control step is added to the tracker when a user selects Git Repository in project setup).