Progress indicator

A progress indicator shows the user where they are along the steps of a journey.

Installation

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

Props

appearance

Description

Sets the color of the indicators.

Default"default"
Type"default" | "help" | "inverted" | "primary"

ariaControls

Description

If interaction is enabled, use ariaControls to tell assistive technology what elements are controlled by the progress indicator.

Default"panel"
Typestring

ariaLabel

Description

Describes what the indicator represents to assistive technology. The selected index number will be appended to the label.

Default"tab"
Typestring

getAriaLabel

Description

Returns the accessible label for each selectable indicator.

Type(index: number) => string

onSelect

Description

Function called when an indicator is selected.

Type(eventData: { event: React.MouseEvent<HTMLButtonElement, MouseEvent>; index: number; }, analyticsEvent: UIAnalyticsEvent) => void

selectedIndex

Required
Description

Which indicator is currently selected.

Typenumber

size

Description

Sets the width and height of each indicator.

Default"default"
Type"default" | "large"

spacing

Description

Specifies how much of a gutter there is between indicators.

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

testId

Description

A hook for automated tests.

Typestring

values

Required
Description

An array of values mapped over to create the indicators.

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