Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

Progress examples · Basic

Empty Progress for React

A progress bar at 0 percent: an empty track before the work starts.

Framework
UI library

A progress bar at 0, before anything has happened: an upload that is queued, an onboarding not yet begun. The empty track shows that progress will appear here, and how far there is to go.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.

FAQ

What does the bar show?

value is 0, so the track is empty. The track is still drawn, so the bar keeps its place in the layout.

Is 0 the same as an indeterminate bar?

No. 0 is a measured amount: the work hasn't started yet. Pass null as value when you can't measure the work; the bar then reports an indeterminate state. For a wait with nothing to measure, a Spinner is usually clearer.

What is the accessible name?

aria-label on Progress, Upload progress. The demo has no visible label, so without it a screen reader would announce a bar with no name.

How do I start filling it?

Change value as the work advances. This demo passes a fixed 0.

Which colors does it use?

The fill is bg-primary and the track bg-muted, from the theme's progress styles. This demo adds no color class.

What if my maximum isn't 100?

Pass value in the same units as the maximum. Set max on Progress: 5 steps of 5 is max 5 and value 5.