Stepper

Show progress through a short sequential flow.

Default

A read-only progress indicator. The current step stretches into a pill and completed steps stay darker. Pass labels so screen readers hear the step name.

Step 1 of 3: Choose a voice

Choose a voice · 1 of 3

Step count

count sets the number of steps; value is the zero-based current step.

Step 1 of 3
Step 3 of 5
Step 7 of 7

Ghost

Removes the neutral fill but keeps the rounded track and padding, for a dialog footer or other framed layout.

Step 2 of 3: Configuration

Interactive

Pass onValueChange to make steps clickable. Arrow keys, Home, and End move between steps once the stepper has focus.

Collect details

Best practices

When to use

  • Use to show progress through a short, ordered flow of 3–7 steps, like agent setup.
  • Use Tabs for peer views and a progress bar or Gauge for measured completion.

Behavior

  • count is the number of steps and value is the zero-based current step. Keep Back and Continue actions next to the content they move.
  • Use variant="ghost" inside a dialog footer or other framed area.
  • Pass onValueChange only when jumping between steps is safe. Arrow keys, Home, and End then move between steps.

Content

  • Show the current step name and “2 of 3” nearby; the dots alone carry no text.

Accessibility

  • Pass labels so the progress announcement reads “Step 2 of 3: Connect a number”, and an aria-label that names the flow.