Skip to content

Progress tracker

Progress trackers guide users through a multi-steps process by letting them know what has already been done and how much is left to complete a task. Apart from showing the number of steps, progress trackers display the current location of the user within the process and allow navigation between the past steps.

Overview

Usage guidelines

When to use
  • To guide users through the completion of a multi-step process, typically a form.
  • To show users where they are in the process and to allow them to navigate between steps.
When not to use
  • To give feedback about the duration of a process that has no determined steps or whose completion depends on the system rather than the users action; use Progress bar instead.
  • To split up content into different pages; use Pagination instead.
  • To split up content into different panels; use Tabs instead.

Writing guidelines

Labels

Communicate clearly what the user will accomplish within each step.

Length

Keep labels short by using one or two words. Avoid sentences or complex words.

Capitalization and case

Write headings in sentence case.

Specifications

Anatomy

Anatomy
  1. Step number (or icon)
  2. Step name (optional): short label describing each step.
  3. Line indicator: visually connects steps and displays status info.
  4. Past step.
  5. Current step.
  6. Inactive step.

Types

There are two types of progress tracker: Number and icon and Stepper.

Docs image
Number and Icon.
Docs image
Stepper
TypeNumber of stepsUsage
Number and iconVariants from 2 to 10 steps are available.Keep in mind that a maximum of 3 steps can fit into a mobile viewport. If you need more than 3 steps, use stepper or the vertical progress tracker with dropdown items. Number and icon variant can be displayed either with numbers only or icons only. Do not mix the two types. Use icon variant when there is a limited number of steps only.
StepperVariants from 2 to 20 steps are availableUse stepper if you need more than 10 steps or if horizontal space is limited.

Variants and sizes

Both Number and icon and Stepper come in a horizontal and a vertical variant.

Number and Icon

Both horizontal and vertical variants come in two sizes: Desktop and tablet and Mobile.

Docs image
Number and icon horizontal, Desktop/tablet
Docs image
Number and icon horizontal, Desktop/tablet
Docs image
Number and icon horizontal, Desktop/tablet
Docs image
Number and icon horizontal, Desktop/tablet

Stepper

Both horizontal and vertical variants come in two sizes: Desktop and tablet and Mobile.

Docs image
Horizontal - Desktop and tablet
Docs image
Horizontal - Mobile
Docs image
Vertical - Desktop and tablet
Docs image
Vertical - Mobile

Styling

Background

Progress tracker is only available to sit on light backgrounds. White or Zurich White are the recommended colors to use so there is enough contrast between the component and the background.

Steps labels

Step labels are not necessary but their use is recommended to ensure a more accessible user experience.

While for number and icon all labels are visible at the same time, for stepper only the current step name is displayed. If you display names, be consistent by making sure to display one for each items.

Number and icon - Steps

In general, steps that have been completed are indicated by a filled circle while the ones to be yet completed are indicated by an outlined circle. The color of each step defines its current state:

  • Zurich Blue for past step
  • Dark Blue for active step
  • Mid Blue for hover on past step
  • Peach for error
  • Grey-8 for inactive step

Number and icon - Line Indicator

Line indicators follow the same color code as the step circle they precede:

  • Zurich Blue for past step
  • Dark Blue for active step
  • Peach for error and Gray-8 for inactive
Default

Stepper - Steps

The color of each step defines its current state:

  • Zurich Blue for past step
  • Dark Blue for active step
  • Peach for error
  • Gray-8 for inactive step
StepperColors

Behavior

Positioning

Give a fixed position to your tracker throughout the process so the user knows where to look for reference about progress. The position should be at the top (for horizontal trackers) or at the side (for vertical trackers) of the content.

Alignment

Be mindful of readability: keep a visual balance and appropriate distance between steps.

Docs image
Docs image

Progress tracker commonly stretches to fit the width of you container. Here there are some best practices:

Docs image
If there are very few steps, it is recommendable to left-align the component.
Docs image
Don't stretch progress tracker excessively to fit the width of your container if it looks unbalanced.

Within the component itself, labels are aligned differently depending on the placement of the step they refers to. The first label is left-aligned relatively to the first step; the last label is right-aligned relatively to the last-step; all the in-between steps are centrally aligned relatively to the step.

Label Alignment

Interaction

The first step of a flow is active by default. Any following step will be actionable once all the previous steps are completed. As soon as a step is completed, immediate feedback on the progress is given.

For number and icon tracker, completed steps are kept actionable to allow users to navigate to previous steps in the process.

Progress Tracker Interaction

This is not the case for stepper, where steps are non-interactive elements. Navigation to previous and next can happen only through additional navigation elements, such as button links or arrows.

Accessibility guidelines

Design Considerations

  • Make sure there is enough contrast between progress tracker color and its background.
  • For a more accessible experience, make use of labels whenever you can and keep them short while being descriptive.