Skip to content
Versions v4 v3 v2 v1

Progress Stepper

A progress stepper displays a timeline of tasks in a workflow and tracks the user's current progress through this workflow.

Installation

We recommend loading elements via a CDN such as JSPM and using an import map to manage your dependencies.

For more information on import maps and how to use them, see the import map reference on MDN Web Docs.

If you are using node and NPM, you can install this component using npm:

npm install @patternfly/elements

Then import this component into your project by using a bare module specifier:

import '@patternfly/elements/pf-progress-stepper/pf-progress-stepper.js';

Please Note You should either load elements via a CDN or install them locally through NPM. Do not do both.

Overview

Completed Issue Failure Running Last

Installation

npm install @patternfly/elements

Usage

Completed Issue Failure Running Last
View HTML Source
<pf-progress-stepper>
  <pf-progress-step variant="success">Completed</pf-progress-step>
  <pf-progress-step current variant="warning">Issue</pf-progress-step>
  <pf-progress-step variant="danger">Failure</pf-progress-step>
  <pf-progress-step variant="info">Running</pf-progress-step>
  <pf-progress-step>Last</pf-progress-step>
</pf-progress-stepper>

Slots

Default Slot

Slots on pf-progress-step

icon

icon Overrides the icon property

Default Slot

Short description of the current step.

description

description Longer description of the current step.

Attributes

vertical

Whether to use the vertical layout

DOM Property
vertical
Type
boolean
Default
false
center

Whether to use the center alignment

DOM Property
center
Type
boolean
Default
false
compact

Whether to use the compact layout

DOM Property
compact
Type
boolean
Default
false

Methods

None

Events

None

CSS Custom Properties

CSS Property Description Default
--pf-global--spacer--xl 2rem
--pf-c-progress-stepper--m-compact__step-connector--MinWidth

Minimum width for compact step connector

1.75rem
--pf-global--icon--FontSize--sm 0.625rem
--pf-c-progress-stepper__step-icon--ZIndex

Z-index for step icon

var(--pf-global--ZIndex--xs, 100)
--pf-global--ZIndex--xs 100
--pf-c-progress-stepper__step-icon--Height

Height of the step icon

var(--pf-c-progress-stepper__step-icon--Width)
--pf-c-progress-stepper__step-icon--Width

Width of the step icon

1.75rem
--pf-c-progress-stepper__step-icon--FontSize

Font size of the step icon

var(--pf-global--FontSize--md, 1rem)
--pf-c-progress-stepper__step-icon--Color

Color of the step icon

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step-icon--BackgroundColor

Background color of the step icon

var(--pf-global--BackgroundColor--light-200, #fafafa)
--pf-global--BackgroundColor--light-200 #fafafa
--pf-c-progress-stepper__step-icon--BorderWidth

Border width of the step icon

var(--pf-global--BorderWidth--md, 2px)
--pf-global--BorderWidth--md 2px
--pf-c-progress-stepper__step-icon--BorderColor

Border color of the step icon

var(--pf-global--BorderColor--100, #d2d2d2)
--pf-global--BorderColor--100 #d2d2d2
--pf-c-progress-stepper__pficon--MarginTop

Top margin for pficon

3px
--pf-c-progress-stepper__fa-exclamation-triangle--MarginTop

Top margin for exclamation triangle icon

-5px
--pf-c-progress-stepper__step-title--Color

Color of the step title

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step-title--TextAlign

Text alignment of the step title

left
--pf-c-progress-stepper__step-title--FontSize

Font size of the step title

var(--pf-global--FontSize--md, 1rem)
--pf-global--FontSize--md 1rem
--pf-c-progress-stepper__step-title--FontWeight

Font weight of the step title

var(--pf-global--FontWeight--normal, 400)
--pf-global--FontWeight--normal 400
--pf-c-progress-stepper__step--m-current__step-title--FontWeight

Font weight for current step title

var(--pf-global--FontWeight--bold, 700)
--pf-global--FontWeight--bold 700
--pf-c-progress-stepper__step--m-current__step-title--Color

Color for current step title

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step--m-pending__step-title--Color

Color for pending step title

var(--pf-global--Color--200, #6a6e73)
--pf-c-progress-stepper__step--m-danger__step-title--Color

Color for danger step title

var(--pf-global--danger-color--100, #c9190b)
--pf-c-progress-stepper__step-title--m-help-text--TextDecorationColor

Text decoration color for help text step title

var(--pf-global--BorderColor--200, #8a8d90)
--pf-global--BorderColor--200 #8a8d90
--pf-c-progress-stepper__step-title--m-help-text--TextDecorationThickness

Text decoration thickness for help text step title

var(--pf-global--BorderWidth--sm, 1px)
--pf-global--BorderWidth--sm 1px
--pf-c-progress-stepper__step-title--m-help-text--TextUnderlineOffset

Text underline offset for help text step title

0.25rem
--pf-c-progress-stepper__step-title--m-help-text--hover--TextDecorationColor

Text decoration color for help text step title on hover

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step-title--m-help-text--focus--TextDecorationColor

Text decoration color for help text step title on focus

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step-title--m-help-text--hover--Color

Color for help text step title on hover

var(--pf-global--Color--100, #151515)
--pf-c-progress-stepper__step-title--m-help-text--focus--Color

Color for help text step title on focus

var(--pf-global--Color--100, #151515)
--pf-global--Color--100 #151515
--pf-c-progress-stepper__step--m-danger__step-title--m-help-text--hover--Color

Color for danger help text step title on hover

var(--pf-global--danger-color--200, #a30000)
--pf-c-progress-stepper__step--m-danger__step-title--m-help-text--focus--Color

Color for danger help text step title on focus

var(--pf-global--danger-color--200, #a30000)
--pf-c-progress-stepper__step--m-danger__step-title--m-help-text--TextDecorationColor

Text decoration color for danger help text step title

var(--pf-global--danger-color--100, #c9190b)
--pf-global--danger-color--100 #c9190b
--pf-c-progress-stepper__step--m-danger__step-title--m-help-text--hover--TextDecorationColor

Text decoration color for danger help text step title on hover

var(--pf-global--danger-color--200, #a30000)
--pf-c-progress-stepper__step--m-danger__step-title--m-help-text--focus--TextDecoerationColor

Text decoration color for danger help text step title on focus

var(--pf-global--danger-color--200, #a30000)
--pf-global--danger-color--200 #a30000
--pf-c-progress-stepper__step-description--MarginTop

Top margin for step description

var(--pf-global--spacer--xs, 0.25rem)
--pf-global--spacer--xs 0.25rem
--pf-c-progress-stepper__step-description--FontSize

Font size of the step description

var(--pf-global--FontSize--sm, 0.875rem)
--pf-global--FontSize--sm 0.875rem
--pf-c-progress-stepper__step-description--Color

Color of the step description

var(--pf-global--Color--200, #6a6e73)
--pf-global--Color--200 #6a6e73
--pf-c-progress-stepper__step-description--TextAlign

Text alignment of the step description

left
--pf-c-progress-stepper__step-connector--before--Top

Top position for step connector pseudo-element (defaults to vertical)

var(--pf-c-progress-stepper--m-vertical__step-connector--before--Top)
--pf-c-progress-stepper--GridTemplateColumns

Grid template columns (defaults to vertical)

var(--pf-c-progress-stepper--m-vertical--GridTemplateColumns)
--pf-c-progress-stepper--GridTemplateRows

Grid template rows

auto 1fr
--pf-c-progress-stepper--m-horizontal--GridAutoFlow

Grid auto flow for horizontal layout

column
--pf-c-progress-stepper--m-horizontal--GridTemplateColumns

Grid template columns for horizontal layout

initial
--pf-c-progress-stepper--m-horizontal__step-connector--before--Top

Top position for horizontal step connector pseudo-element

calc(var(--pf-c-progress-stepper__step-icon--Height) / 2)
--pf-c-progress-stepper--m-horizontal__step-connector--before--Left

Left position for horizontal step connector pseudo-element

0
--pf-c-progress-stepper--m-horizontal__step-connector--before--Width

Width for horizontal step connector pseudo-element

100%
--pf-c-progress-stepper--m-horizontal__step-connector--before--Height

Height for horizontal step connector pseudo-element

auto
--pf-c-progress-stepper--m-horizontal__step-connector--before--BorderRightWidth

Right border width for horizontal step connector pseudo-element

0
--pf-c-progress-stepper--m-horizontal__step-connector--before--BorderRightColor

Right border color for horizontal step connector pseudo-element

unset
--pf-c-progress-stepper--m-horizontal__step-connector--before--BorderBottomWidth

Bottom border width for horizontal step connector pseudo-element

var(--pf-global--BorderWidth--md, 2px)
--pf-c-progress-stepper--m-horizontal__step-connector--before--BorderBottomColor

Bottom border color for horizontal step connector pseudo-element

var(--pf-global--BorderColor--100, #d2d2d2)
--pf-c-progress-stepper--m-horizontal__step-connector--before--Transform

Transform for horizontal step connector pseudo-element

translateY(-50%)
--pf-c-progress-stepper--m-horizontal__step-main--MarginTop

Top margin for horizontal step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-horizontal__step-main--MarginRight

Right margin for horizontal step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-horizontal__step-main--MarginBottom

Bottom margin for horizontal step main content

0
--pf-c-progress-stepper--m-horizontal__step-main--MarginLeft

Left margin for horizontal step main content

0
--pf-c-progress-stepper--m-horizontal--m-compact--GridTemplateColumns

Grid template columns for horizontal compact layout

repeat(auto-fill, 1.75rem)
--pf-c-progress-stepper--m-horizontal--m-compact__step-connector--GridRow

Grid row for horizontal compact step connector

2
--pf-c-progress-stepper--m-horizontal--m-compact__step-connector--PaddingBottom

Padding bottom for horizontal compact step connector

0
--pf-c-progress-stepper__step-connector--JustifyContent

Justify content for step connector

var(--pf-c-progress-stepper--m-center__step-connector--JustifyContent)
--pf-c-progress-stepper--m-center__step-connector--JustifyContent

Justify content for centered step connector

center
--pf-c-progress-stepper--m-center__step-main--MarginRight

Right margin for centered step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-center__step-main--MarginLeft

Left margin for centered step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-center__step-main--TextAlign

Text alignment for centered step main content

auto
--pf-c-progress-stepper--m-center__step-title--TextAlign auto
--pf-c-progress-stepper--m-center__step-description--MarginRight

Right margin for centered step description

0
--pf-c-progress-stepper--m-center__step-description--MarginLeft

Left margin for centered step description

0
--pf-c-progress-stepper--m-center__step-description--TextAlign auto
--pf-c-progress-stepper--m-vertical--m-center__step-main--MarginRight

Right margin for vertical centered step main content

0
--pf-c-progress-stepper--m-vertical--m-center__step-main--MarginLeft

Left margin for vertical centered step main content

0
--pf-c-progress-stepper--m-center--GridTemplateColumns

Grid template columns for centered layout

1fr
--pf-c-progress-stepper__step-main--before--Content var(--pf-c-progress-stepper--m-center__step-main--before--Content)
--pf-c-progress-stepper--m-center__step-main--before--Content
--pf-c-progress-stepper--m-center__step-connector--before--Content
--pf-c-progress-stepper--GridAutoFlow

Grid auto flow (defaults to vertical)

var(--pf-c-progress-stepper--m-vertical--GridAutoFlow)
--pf-c-progress-stepper--m-vertical--GridAutoFlow

Grid auto flow for vertical layout

row
--pf-c-progress-stepper--m-vertical--GridTemplateColumns

Grid template columns for vertical layout

auto 1fr
--pf-c-progress-stepper--m-vertical__step-connector--before--Top

Top position for vertical step connector pseudo-element

0
--pf-c-progress-stepper--m-vertical__step-connector--before--Left

Left position for vertical step connector pseudo-element

calc(var(--pf-c-progress-stepper__step-icon--Width) / 2)
--pf-c-progress-stepper--m-vertical__step-connector--before--Width

Width for vertical step connector pseudo-element

auto
--pf-c-progress-stepper--m-vertical__step-connector--before--Height

Height for vertical step connector pseudo-element

100%
--pf-c-progress-stepper--m-vertical__step-connector--before--BorderRightWidth

Right border width for vertical step connector pseudo-element

var(--pf-global--BorderWidth--md, 2px)
--pf-c-progress-stepper--m-vertical__step-connector--before--BorderRightColor

Right border color for vertical step connector pseudo-element

var(--pf-global--BorderColor--100, #d2d2d2)
--pf-c-progress-stepper--m-vertical__step-connector--before--BorderBottomWidth

Bottom border width for vertical step connector pseudo-element

0
--pf-c-progress-stepper--m-vertical__step-connector--before--BorderBottomColor

Bottom border color for vertical step connector pseudo-element

transparent
--pf-c-progress-stepper--m-vertical__step-connector--before--Transform

Transform for vertical step connector pseudo-element

translateX(-50%)
--pf-c-progress-stepper--m-vertical__step-main--MarginTop

Top margin for vertical step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-vertical__step-main--MarginRight

Right margin for vertical step main content

0
--pf-c-progress-stepper--m-vertical__step-main--MarginBottom

Bottom margin for vertical step main content

var(--pf-global--spacer--xl, 2rem)
--pf-c-progress-stepper--m-vertical__step-main--MarginLeft

Left margin for vertical step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-vertical--m-compact--GridTemplateColumns

Grid template columns for vertical compact layout

1fr
--pf-c-progress-stepper--m-vertical--m-compact__step-connector--GridRow

Grid row for vertical compact step connector

auto
--pf-c-progress-stepper--m-vertical--m-compact__step-connector--PaddingBottom

Padding bottom for vertical compact step connector

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper__step-connector--before--Left var(--pf-c-progress-stepper--m-center__step-connector--before--Left)
--pf-c-progress-stepper--m-center__step-connector--before--Left

Left position for centered step connector pseudo-element

50%
--pf-c-progress-stepper__step-main--MarginTop var(--pf-c-progress-stepper--m-compact__step-main--MarginTop)
--pf-c-progress-stepper--m-compact__step-main--MarginTop

Top margin for compact step main content

0
--pf-c-progress-stepper--m-compact__step-main--MarginBottom

Bottom margin for compact step main content

var(--pf-global--spacer--xs, 0.25rem)
--pf-c-progress-stepper--m-compact__step-icon--Width

Width for compact step icon

1.125rem
--pf-c-progress-stepper--m-compact__step-icon--FontSize

Font size for compact step icon

var(--pf-global--icon--FontSize--sm, 0.625rem)
--pf-c-progress-stepper--m-compact__step-title--FontSize

Font size for compact step title

var(--pf-global--FontSize--sm, 0.875rem)
--pf-c-progress-stepper--m-compact__step-title--FontWeight

Font weight for compact step title

var(--pf-global--FontWeight--normal, 400)
--pf-c-progress-stepper--m-compact__pficon--MarginTop

Top margin for compact pficon

2px
--pf-c-progress-stepper--m-compact__fa-exclamation-triangle--MarginTop

Top margin for compact exclamation triangle icon

-3px
--pf-c-progress-stepper--m-vertical--m-compact__step-main--MarginLeft
--pf-c-progress-stepper--m-vertical--m-compact__step-main--MarginRight

Right margin for vertical compact step main content

0
--pf-c-progress-stepper--m-compact--GridTemplateColumns
--pf-c-progress-stepper--m-compact--GridAutoFlow

Grid auto flow for compact layout

row

CSS Shadow Parts

None

© 2018-2025 Red Hat, Inc. Deploys by Netlify