Live demo — this example is server-driven; run the showcase locally for the interactive version.

Progress stepper

Visualize progress through a sequence of named steps — pipeline stages, multi-step workflows, deployment phases. Each step has a state (success / current / pending) and an icon.

Examples

Basic (horizontal)

Success, current, and pending steps with descriptions.

  1. Step 1
    Completed
  2. Step 2
    In progress
  3. Step 3
    Pending

Vertical

pf-m-vertical.

  1. Configure
    Pipeline configured.
  2. Build
    Compiling sources…
  3. Deploy
    Waiting for build.

Vertical, horizontal responsive

pf-m-vertical-on-lg + pf-m-horizontal-on-2xl — vertical below lg, horizontal again from 2xl.

  1. First step
    Completed
  2. Second step
    In progress
  3. Third step
    Pending

Compact

pf-m-compact.

  1. First step
    Completed
  2. Second step
    In process
  3. Third step
    Pending

Compact, vertical

pf-m-compact pf-m-vertical.

  1. First step
  2. Second step
  3. Third step

Compact, vertical responsive

pf-m-compact with pf-m-vertical-on-lg pf-m-horizontal-on-xl.

  1. First step
  2. Second step
  3. Third step

Compact, vertical, centered

pf-m-compact pf-m-vertical pf-m-center.

  1. First step
  2. Second step
  3. Third step

Compact, centered

pf-m-compact pf-m-center.

  1. First step
  2. Second step
  3. Third step

With alignment

pf-m-center centers titles under the icons.

  1. First step
    Completed
  2. Second step
    In progress
  3. Third step
    Pending

Center aligned, vertical

pf-m-center pf-m-vertical with descriptions.

  1. First step
    Completed
  2. Second step
    In progress
  3. Third step
    Pending

With an issue

A pf-m-warning step flags a non-blocking problem.

  1. Built
  2. Tests passed with warnings
  3. Deploying
  4. Released

With a failure

A pf-m-danger step halts the flow.

  1. Built
  2. Tests
  3. Deploy failed
  4. Released

Basic in process

The current step’s icon is an xs spinner (core’s IsInProgressAnimate).

  1. Successful completion
  2. In process
  3. Pending

With custom icons

pf-m-custom steps carry arbitrary icons.

  1. Code
    Pushed to main
  2. Build
    Image built
  3. Ship
    Awaiting approval

With help popover

The current step\u2019s title opens a popover (pf-m-help-text).

  1. First step
  2. Second step
  3. Third step

Documentation

Progress stepper props

Parameters accepted by {#include components/feedback/progress-stepper ... /}. Model mode: pass stepper=<ProgressStepper> built in Java instead — the Java tab on each example shows the builder. Steps go in the slot — each is a <li> with state-modifier classes.

* required
Name Type Description
* id String DOM id.
vertical / compact / center boolean Layout modifiers — emit matching pf-m-* on the <ol>.
slot content Qute block <li class="pf-v6-c-progress-stepper__step ..."> entries with their state classes.

Usage

One step is current. Mark exactly one step with pf-m-current + aria-current="step". Past steps get pf-m-success (or other terminal states); future steps get no state class.

Live updates. Wrap the <ol> in an HTMX target and re-render server-side as steps progress.