Skip to Content
Columbus

Progress

A visual indicator showing the completion status of a task.

x

Installation

pnpm dlx shadcn@latest add @columbus/progress

Usage

import { Progress } from "@/components/ui/progress";

<Progress aria-label="Uploading files" value={40} />;

With no children, Progress renders a track and indicator. If you pass children, include ProgressTrack and ProgressIndicator yourself.

With label and value

ProgressLabel also names the progress bar for screen readers.

Export data
x

Formatted value

Pass a function to ProgressValue to format what it shows.

Upload
x

Indeterminate

Set value={null} when you can't tell how much is left.

<Progress aria-label="Connecting" value={null} />

API reference

Progress wraps Base UI Progress. Each part accepts the props of its Base UI counterpart.

PartBase UI part
ProgressProgress.Root
ProgressLabelProgress.Label
ProgressTrackProgress.Track
ProgressIndicatorProgress.Indicator
ProgressValueProgress.Value

Prop

Type

On this page