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.