Skip to main content

Components

Progress

Progress bars with labels, stacking, stripes and a CSS stripe animation.

How it works

A progress bar is two nested divs: .progress is the track and .progress-bar is the fill, sized with an inline width. There is no script — the width is set in markup by whatever renders the page. The theme fills the bar with gold and navy text; the track is the secondary background.

  • Baseline: plain HTML and CSS. Works everywhere.
  • Enhancement: .progress-bar-animated is a CSS keyframe animation; it stops under prefers-reduced-motion.
  • Fallback: none needed.

Put the ARIA attributes on the outer .progress, as Bootstrap 5.3 does: role="progressbar", aria-label, aria-valuenow, aria-valuemin and aria-valuemax.

Basic example

HTML
<div class="progress mb-3" role="progressbar" aria-label="Basic example" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 0%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Basic example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 25%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Basic example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 50%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Basic example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 75%"></div>
</div>
<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 100%"></div>
</div>

Bar sizing

Width

Besides inline styles, width utilities set the fill.

HTML
<div class="progress" role="progressbar" aria-label="Basic example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar w-75"></div>
</div>

Height

Set height on the outer .progress; the bar follows.

HTML
<div class="progress mb-3" role="progressbar" aria-label="Example 1px high" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100" style="height: 1px">
  <div class="progress-bar" style="width: 25%"></div>
</div>
<div class="progress" role="progressbar" aria-label="Example 20px high" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100" style="height: 20px">
  <div class="progress-bar" style="width: 25%"></div>
</div>

Labels

Put text inside .progress-bar. It is navy on the gold fill.

25%
HTML
<div class="progress" role="progressbar" aria-label="Example with label" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar" style="width: 25%">25%</div>
</div>

A label on a very narrow bar overflows and is clipped. Add .overflow-visible and a text colour so it spills out legibly.

Long label text for the progress bar, set to a dark color
HTML
<div class="progress" role="progressbar" aria-label="Example with label" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar overflow-visible text-dark" style="width: 10%">Long label text for the progress bar, set to a dark color</div>
</div>

Backgrounds

Background utilities recolour the bar. If the label needs to stay readable, use .text-bg-* instead of .bg-* so the text colour comes along.

HTML
<div class="progress mb-3" role="progressbar" aria-label="Success example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar bg-success" style="width: 25%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Info example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar bg-info" style="width: 50%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Warning example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar bg-warning" style="width: 75%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Danger example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar bg-danger" style="width: 100%"></div>
</div>
<div class="progress" role="progressbar" aria-label="Navy example" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar bg-navy" style="width: 60%"></div>
</div>
25%
50%
75%
100%
60%
HTML
<div class="progress mb-3" role="progressbar" aria-label="Success example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar text-bg-success" style="width: 25%">25%</div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Info example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar text-bg-info" style="width: 50%">50%</div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Warning example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar text-bg-warning" style="width: 75%">75%</div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Danger example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar text-bg-danger" style="width: 100%">100%</div>
</div>
<div class="progress" role="progressbar" aria-label="Navy example" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar text-bg-navy" style="width: 60%">60%</div>
</div>

Multiple bars

Wrap several .progress elements in .progress-stacked. Move the inline width to the outer .progress; each inner bar is then 100 % of its segment.

HTML
<div class="progress-stacked">
  <div class="progress" role="progressbar" aria-label="Segment one" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100" style="width: 15%">
    <div class="progress-bar"></div>
  </div>
  <div class="progress" role="progressbar" aria-label="Segment two" aria-valuenow="30" aria-valuemin="0" aria-valuemax="100" style="width: 30%">
    <div class="progress-bar bg-success"></div>
  </div>
  <div class="progress" role="progressbar" aria-label="Segment three" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
    <div class="progress-bar bg-info"></div>
  </div>
</div>

Striped

.progress-bar-striped adds a translucent stripe over whatever background colour is set.

HTML
<div class="progress mb-3" role="progressbar" aria-label="Default striped example" aria-valuenow="10" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped" style="width: 10%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Success striped example" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped bg-success" style="width: 25%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Info striped example" aria-valuenow="50" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped bg-info" style="width: 50%"></div>
</div>
<div class="progress mb-3" role="progressbar" aria-label="Warning striped example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped bg-warning" style="width: 75%"></div>
</div>
<div class="progress" role="progressbar" aria-label="Danger striped example" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped bg-danger" style="width: 100%"></div>
</div>

Animated stripes

Add .progress-bar-animated to a striped bar. The stripes slide left to right on a one-second CSS loop — this always worked without JavaScript. It is disabled when the user prefers reduced motion.

HTML
<div class="progress" role="progressbar" aria-label="Animated striped example" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100">
  <div class="progress-bar progress-bar-striped progress-bar-animated" style="width: 75%"></div>
</div>

CSS

Local variables on .progress and .progress-stacked. The fill is gold-700 in light mode and gold-500 in dark mode.

.progress,
.progress-stacked {
  --bs-progress-height: 1rem;
  --bs-progress-font-size: 0.75rem;
  --bs-progress-bg: var(--bs-secondary-bg);
  --bs-progress-border-radius: 2px;
  --bs-progress-box-shadow: var(--bs-box-shadow-inset);
  --bs-progress-bar-color: #0a1b3d;
  --bs-progress-bar-bg: #b8941f;
  --bs-progress-bar-transition: width 0.6s ease;
}

[data-bs-theme="dark"] .progress,
[data-bs-theme="dark"] .progress-stacked {
  --bs-progress-bar-bg: var(--bs-gold-500);
}

Change the height or colour for one bar with an inline style:

40%
HTML
<div class="progress" role="progressbar" aria-label="Custom bar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="--bs-progress-height: 1.5rem; --bs-progress-bar-bg: var(--bs-navy); --bs-progress-bar-color: var(--bs-cream);">
  <div class="progress-bar" style="width: 40%">40%</div>
</div>