Progress tracker

A progress tracker displays the steps and progress through a journey.

Installation

Package installation information
Installyarn add @atlaskit/progress-tracker
SourceBitbucket.org, (opens new window)
npm@atlaskit/progress-tracker, (opens new window)
Bundleunpkg.com, (opens new window)

Props

animated

Description

Turns off transition animations if set to false.

Defaulttrue
Typeboolean

items

Required
Description

Ordered list of stage data.

Default[]
TypeStage[]

label

Description

Use this to provide an aria-label for the overall progress tracker, so that people who use assistive technology get an overview of the tracker's purpose. For example, "Sign up progress".

Default"Progress"
Typestring

render

Deprecated
Description

Render prop to specify custom implementations of components.

Note this is deprecated and will be removed in a future version. Links inside progress tracker can be configured using App Provider instead.

Default{ link: ({ item }: LinkComponentProps) => ( // Anchor content is coming from another location // eslint-disable-next-line @atlassian/a11y/anchor-has-content <Link {...item} /> ), }
TypeProgressTrackerStageRenderProp

spacing

Description

Sets the amount of spacing between the steps.

Default"cozy"
Type"cozy" | "comfortable" | "compact"

testId

Description

A testId prop is provided for specified elements, which is a unique string that appears as a data attribute data-testid in the rendered code, serving as a hook for automated tests.

Typestring
Was this page helpful?
We use this feedback to improve our documentation.
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License