Bootstrap Progress Bar: 16 Examples, From Striped to Circular

Bootstrap builds a progress bar out of two divs: the outer .progress track and the inner .progress-bar fill. One change in v5.3.0 catches people out. The role="progressbar" and value attributes now go on the .progress wrapper, not on the inner bar.

Below are 16 Bootstrap progress bar examples you can copy, followed by a guide to markup, labels, colors, stacking, JavaScript updates and theming.

By Bogdan Sandu ยท Updated October 29, 2026

Every example runs on Bootstrap 5.3.8 from the jsDelivr CDN. Add these tags to your page, then paste an example's HTML, CSS and JS.

<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB" crossorigin="anonymous">
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.2/font/bootstrap-icons.min.css" rel="stylesheet" integrity="sha384-nWN3KqaaVcbEsCjLSV+2jMjh62Iny/+mN3srM8TZeM8N6aj7eDl5wwYggjAJ4/sJ" crossorigin="anonymous">
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.bundle.min.js" integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI" crossorigin="anonymous"></script>

Labels, colors, stripes and stacks

The core progress component in its 5.3 markup: role and value attributes on the .progress wrapper, the fill on .progress-bar, and .progress-stacked for segments. Every color comes with a text label so the state never depends on color alone.

Labels, heights and outside text

  • .progress
  • role="progressbar"
  • aria-labelledby
  • --bs-progress-height
  • --bs-progress-font-size

Three bars with three label strategies: a 6px bar with its value printed outside, a default 1rem bar with the value inside the fill, and a taller bar sized through --bs-progress-height so the label has room. Each wrapper takes its accessible name from the visible text with aria-labelledby.

View code
<div class="card border-0 shadow-sm bpb-basic">
  <div class="card-body p-4">
    <h3 class="h6 mb-1">Website relaunch</h3>
    <p class="small text-body-secondary mb-4">Northwind Ceramics, sprint 6 of 8</p>
    <div class="d-flex justify-content-between small mb-1">
      <span id="bpb-lbl-design">Design handoff</span>
      <span class="fw-semibold">8%</span>
    </div>
    <div class="progress mb-4" role="progressbar" aria-labelledby="bpb-lbl-design" aria-valuenow="8" aria-valuemin="0" aria-valuemax="100" style="height: 6px">
      <div class="progress-bar" style="width: 8%"></div>
    </div>
    <p class="small mb-1" id="bpb-lbl-copy">Copywriting</p>
    <div class="progress mb-4" role="progressbar" aria-labelledby="bpb-lbl-copy" aria-valuenow="45" aria-valuemin="0" aria-valuemax="100">
      <div class="progress-bar" style="width: 45%">45%</div>
    </div>
    <p class="small mb-1" id="bpb-lbl-dev">Development</p>
    <div class="progress" role="progressbar" aria-labelledby="bpb-lbl-dev" aria-valuenow="72" aria-valuemin="0" aria-valuemax="100" style="--bs-progress-height: 1.5rem; --bs-progress-font-size: .875rem">
      <div class="progress-bar" style="width: 72%">72% complete</div>
    </div>
  </div>
</div>

Plan usage with status colors and text

  • text-bg-success
  • text-bg-warning
  • text-bg-danger
  • bg-*-subtle
  • text-*-emphasis

The text-bg-* helpers color each fill and pick a readable label color in one class, so the white and black labels keep their contrast. The meaning is repeated in a subtle badge next to each row, because a screen reader never hears that a bar is red.

View code
<div class="card border-0 shadow-sm bpb-usage">
  <div class="card-body p-4">
    <div class="d-flex justify-content-between align-items-baseline mb-4">
      <h3 class="h6 mb-0">Plan usage</h3>
      <span class="small text-body-secondary">Resets Nov 1</span>
    </div>
    <div class="mb-4">
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span id="bpb-use-api">API requests</span>
        <span class="badge bg-success-subtle text-success-emphasis"><i class="bi bi-check-circle me-1" aria-hidden="true"></i>Healthy</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-use-api" aria-valuenow="42" aria-valuemin="0" aria-valuemax="100" aria-valuetext="42 percent, healthy">
        <div class="progress-bar text-bg-success" style="width: 42%">42%</div>
      </div>
    </div>
    <div class="mb-4">
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span id="bpb-use-bw">Bandwidth</span>
        <span class="badge bg-warning-subtle text-warning-emphasis"><i class="bi bi-exclamation-triangle me-1" aria-hidden="true"></i>Near limit</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-use-bw" aria-valuenow="78" aria-valuemin="0" aria-valuemax="100" aria-valuetext="78 percent, near limit">
        <div class="progress-bar text-bg-warning" style="width: 78%">78%</div>
      </div>
    </div>
    <div>
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span id="bpb-use-seats">Team seats</span>
        <span class="badge bg-danger-subtle text-danger-emphasis"><i class="bi bi-x-octagon me-1" aria-hidden="true"></i>Over 95%</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-use-seats" aria-valuenow="96" aria-valuemin="0" aria-valuemax="100" aria-valuetext="96 percent, over the limit warning">
        <div class="progress-bar text-bg-danger" style="width: 96%">24 of 25 seats</div>
      </div>
    </div>
  </div>
</div>

Striped and animated import job

  • progress-bar-striped
  • progress-bar-animated
  • --bs-progress-height
  • classList.toggle

Click Pause import to stop the moving stripes.

The finished file keeps still stripes, the running one adds progress-bar-animated, and the Pause button simply toggles that class. Bootstrap 5.3.8 already switches the stripe animation off under prefers-reduced-motion: reduce, and the stripe tile follows --bs-progress-height, so the height is set through the variable.

View code
<div class="card border-0 shadow-sm bpb-import">
  <div class="card-body p-4">
    <div class="d-flex justify-content-between align-items-center mb-4">
      <h3 class="h6 mb-0">CRM import</h3>
      <span class="badge text-bg-primary" id="bpb-imp-state">Running</span>
    </div>
    <div class="d-flex justify-content-between small mb-1">
      <span id="bpb-imp-a">customers.csv</span>
      <span class="text-success-emphasis fw-semibold">12,480 rows imported</span>
    </div>
    <div class="progress mb-4" role="progressbar" aria-labelledby="bpb-imp-a" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100">
      <div class="progress-bar progress-bar-striped bg-success" style="width: 100%"></div>
    </div>
    <div class="d-flex justify-content-between small mb-1">
      <span id="bpb-imp-b">orders.csv</span>
      <span class="text-body-secondary">31,200 of 48,750 rows</span>
    </div>
    <div class="progress mb-4" role="progressbar" aria-labelledby="bpb-imp-b" aria-valuenow="64" aria-valuemin="0" aria-valuemax="100">
      <div class="progress-bar progress-bar-striped progress-bar-animated" id="bpb-imp-bar" style="width: 64%">64%</div>
    </div>
    <button type="button" class="btn btn-outline-secondary bpb-imp-btn" id="bpb-imp-toggle"><i class="bi bi-pause-fill me-1" id="bpb-imp-icon" aria-hidden="true"></i><span id="bpb-imp-label">Pause import</span></button>
  </div>
</div>

Stacked storage meter with a legend

  • .progress-stacked
  • --bs-progress-bar-bg
  • aria-label
  • list-unstyled

A .progress-stacked container holds one .progress per file type, and each segment carries its own width, role, value and name. The segment colors are set with --bs-progress-bar-bg on each .progress, and the legend reuses the same classes so its swatches always match.

View code
<div class="card border-0 shadow-sm bpb-store">
  <div class="card-body p-4">
    <h3 class="h6 mb-1">Storage</h3>
    <p class="mb-3"><span class="fs-4 fw-semibold">38.5 GB</span> <span class="text-body-secondary">of 50 GB used</span></p>
    <div class="progress-stacked mb-4">
      <div class="progress bpb-seg-photo" role="progressbar" aria-label="Photos, 17 GB" aria-valuenow="34" aria-valuemin="0" aria-valuemax="100" style="width: 34%">
        <div class="progress-bar"></div>
      </div>
      <div class="progress bpb-seg-video" role="progressbar" aria-label="Video, 11 GB" aria-valuenow="22" aria-valuemin="0" aria-valuemax="100" style="width: 22%">
        <div class="progress-bar"></div>
      </div>
      <div class="progress bpb-seg-docs" role="progressbar" aria-label="Documents, 6 GB" aria-valuenow="12" aria-valuemin="0" aria-valuemax="100" style="width: 12%">
        <div class="progress-bar"></div>
      </div>
      <div class="progress bpb-seg-backup" role="progressbar" aria-label="Backups, 4.5 GB" aria-valuenow="9" aria-valuemin="0" aria-valuemax="100" style="width: 9%">
        <div class="progress-bar"></div>
      </div>
    </div>
    <ul class="list-unstyled row row-cols-2 g-2 small mb-4">
      <li class="col d-flex align-items-center gap-2"><span class="bpb-swatch bpb-seg-photo" aria-hidden="true"></span>Photos <span class="ms-auto text-body-secondary">17 GB</span></li>
      <li class="col d-flex align-items-center gap-2"><span class="bpb-swatch bpb-seg-video" aria-hidden="true"></span>Video <span class="ms-auto text-body-secondary">11 GB</span></li>
      <li class="col d-flex align-items-center gap-2"><span class="bpb-swatch bpb-seg-docs" aria-hidden="true"></span>Documents <span class="ms-auto text-body-secondary">6 GB</span></li>
      <li class="col d-flex align-items-center gap-2"><span class="bpb-swatch bpb-seg-backup" aria-hidden="true"></span>Backups <span class="ms-auto text-body-secondary">4.5 GB</span></li>
    </ul>
    <div class="d-flex justify-content-between align-items-center gap-3">
      <span class="small text-body-secondary">11.5 GB free</span>
      <a href="#" class="btn btn-dark btn-sm">Upgrade to 200 GB</a>
    </div>
  </div>
</div>

Steps, goals and completion

Progress bars inside real product UI: a checkout stepper, a fundraising card, a profile checklist and a course list. Each one keeps aria-valuenow, the width and the visible text in sync.

Checkout progress with labelled steps

  • aria-valuetext
  • aria-current="step"
  • --bs-progress-height
  • visually-hidden

Click Continue or Back to move through the checkout.

The bar uses the step as its value (aria-valuenow 2, aria-valuemax 4) and aria-valuetext reads "Step 2 of 4, Shipping" instead of a bare number. Under it a step list marks the current step with aria-current and finished steps with a check plus visually hidden text.

View code
<div class="card border-0 shadow-sm bpb-checkout">
  <div class="card-body p-4">
    <p class="small text-body-secondary mb-1">Lark &amp; Loom checkout</p>
    <h3 class="h5 mb-3" id="bpb-co-title">Step 2 of 4: Shipping</h3>
    <div class="progress mb-2" id="bpb-co-progress" role="progressbar" aria-labelledby="bpb-co-title" aria-valuenow="2" aria-valuemin="0" aria-valuemax="4" aria-valuetext="Step 2 of 4, Shipping">
      <div class="progress-bar" style="width: 50%"></div>
    </div>
    <ol class="list-unstyled d-flex justify-content-between small mb-4 bpb-co-steps">
      <li class="bpb-co-step bpb-co-done"><span class="bpb-co-dot" aria-hidden="true"><i class="bi bi-check-lg"></i></span>Cart<span class="visually-hidden bpb-co-sr">, completed</span></li>
      <li class="bpb-co-step bpb-co-current" aria-current="step"><span class="bpb-co-dot" aria-hidden="true"><i class="bi bi-check-lg"></i></span>Shipping<span class="visually-hidden bpb-co-sr"></span></li>
      <li class="bpb-co-step"><span class="bpb-co-dot" aria-hidden="true"><i class="bi bi-check-lg"></i></span>Payment<span class="visually-hidden bpb-co-sr"></span></li>
      <li class="bpb-co-step"><span class="bpb-co-dot" aria-hidden="true"><i class="bi bi-check-lg"></i></span>Review<span class="visually-hidden bpb-co-sr"></span></li>
    </ol>
    <div class="border rounded-3 p-3 mb-4 bg-body-tertiary">
      <p class="mb-0 small" id="bpb-co-text">Standard delivery to 14 Harcourt Row, Leeds. Arrives in 3 to 5 working days.</p>
    </div>
    <div class="d-flex gap-2">
      <button type="button" class="btn btn-outline-secondary bpb-co-btn" id="bpb-co-back">Back</button>
      <button type="button" class="btn btn-primary flex-grow-1 bpb-co-btn" id="bpb-co-next">Continue</button>
    </div>
  </div>
</div>

Fundraising goal card

  • card-img-top
  • btn-check
  • aria-valuetext
  • role="status"
  • --bs-btn-*

Pick an amount and click Back this project.

The bar measures dollars, so aria-valuemax is the goal (25000) and aria-valuetext turns the raw number into "$18,640 of $25,000". Amount chips are btn-check radios, and a donation updates the width, the ARIA values and the totals, with a role="status" line confirming it.

View code
<div class="card border-0 shadow-sm overflow-hidden bpb-fund">
  <img src="forest-waterfall.webp" class="card-img-top bpb-fund-img" width="800" height="600" alt="Waterfall dropping into a mossy green gorge surrounded by fir forest">
  <div class="card-body p-4">
    <h3 class="h5 mb-1" id="bpb-fund-title">Restore the Falls Creek trail</h3>
    <p class="small text-body-secondary mb-3">Cedar Ridge Trail Alliance</p>
    <p class="mb-2"><span class="fs-4 fw-semibold" id="bpb-fund-raised">$18,640</span> <span class="text-body-secondary">raised of $25,000</span></p>
    <div class="progress mb-3" id="bpb-fund-progress" role="progressbar" aria-labelledby="bpb-fund-title" aria-valuenow="18640" aria-valuemin="0" aria-valuemax="25000" aria-valuetext="$18,640 of $25,000">
      <div class="progress-bar" style="width: 74.56%"></div>
    </div>
    <div class="d-flex justify-content-between small text-body-secondary mb-4">
      <span><strong class="text-body" id="bpb-fund-backers">412</strong> backers</span>
      <span><strong class="text-body" id="bpb-fund-pct">75%</strong> funded</span>
      <span><strong class="text-body">9</strong> days left</span>
    </div>
    <div class="d-flex gap-2 mb-3" role="group" aria-label="Donation amount">
      <input type="radio" class="btn-check" name="bpb-amount" id="bpb-amt-10" value="10" autocomplete="off">
      <label class="btn btn-outline-secondary flex-fill bpb-amt" for="bpb-amt-10">$10</label>
      <input type="radio" class="btn-check" name="bpb-amount" id="bpb-amt-25" value="25" autocomplete="off" checked>
      <label class="btn btn-outline-secondary flex-fill bpb-amt" for="bpb-amt-25">$25</label>
      <input type="radio" class="btn-check" name="bpb-amount" id="bpb-amt-50" value="50" autocomplete="off">
      <label class="btn btn-outline-secondary flex-fill bpb-amt" for="bpb-amt-50">$50</label>
    </div>
    <button type="button" class="btn w-100 bpb-fund-btn" id="bpb-fund-give">Back this project with $25</button>
    <p class="small text-success-emphasis mt-3 mb-0" id="bpb-fund-status" role="status"></p>
  </div>
</div>

Profile completion checklist

  • form-check
  • text-bg-success
  • aria-describedby
  • change event

Tick the remaining tasks.

Each ticked form-check adds 20% to the bar, and the counter text says "3 of 5 done" so the value is readable without the bar. At 100% the fill switches to bg-success and the heading changes, so the finished state is announced in words too.

View code
<div class="card border-0 shadow-sm bpb-profile">
  <div class="card-body p-4">
    <div class="d-flex align-items-center gap-3 mb-3">
      <span class="bpb-avatar" aria-hidden="true">JR</span>
      <div>
        <h3 class="h6 mb-0" id="bpb-pc-title">Finish setting up your profile</h3>
        <p class="small text-body-secondary mb-0" id="bpb-pc-count">2 of 5 done</p>
      </div>
    </div>
    <div class="progress mb-4" id="bpb-pc-progress" role="progressbar" aria-labelledby="bpb-pc-title" aria-describedby="bpb-pc-count" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100">
      <div class="progress-bar" style="width: 40%"></div>
    </div>
    <div class="d-grid gap-2">
      <div class="form-check bpb-task">
        <input class="form-check-input bpb-pc-task" type="checkbox" id="bpb-pc-1" checked>
        <label class="form-check-label" for="bpb-pc-1">Verify your email</label>
      </div>
      <div class="form-check bpb-task">
        <input class="form-check-input bpb-pc-task" type="checkbox" id="bpb-pc-2" checked>
        <label class="form-check-label" for="bpb-pc-2">Add a display name</label>
      </div>
      <div class="form-check bpb-task">
        <input class="form-check-input bpb-pc-task" type="checkbox" id="bpb-pc-3">
        <label class="form-check-label" for="bpb-pc-3">Upload a profile photo</label>
      </div>
      <div class="form-check bpb-task">
        <input class="form-check-input bpb-pc-task" type="checkbox" id="bpb-pc-4">
        <label class="form-check-label" for="bpb-pc-4">Write a short bio</label>
      </div>
      <div class="form-check bpb-task">
        <input class="form-check-input bpb-pc-task" type="checkbox" id="bpb-pc-5">
        <label class="form-check-label" for="bpb-pc-5">Turn on two-step sign-in</label>
      </div>
    </div>
  </div>
</div>

Course progress list

  • list-group
  • --bs-progress-height
  • aria-valuemax
  • badge

Click the buttons or tick the boxes to move the bars.

A list-group of enrolled courses where each thin bar counts lessons, so aria-valuemax is the lesson total rather than 100 and the width is value divided by total. The text "12 of 20 lessons" sits beside the bar because a 6px fill has no room for a label.

View code
<div class="card border-0 shadow-sm bpb-courses">
  <div class="card-header bg-body border-0 pt-4 px-4 pb-2">
    <h3 class="h6 mb-0">My courses</h3>
  </div>
  <ul class="list-group list-group-flush">
    <li class="list-group-item px-4 py-3">
      <div class="d-flex justify-content-between gap-3 mb-2">
        <div>
          <p class="fw-semibold mb-0" id="bpb-course-1">Typography for interfaces</p>
          <p class="small text-body-secondary mb-0">12 of 20 lessons</p>
        </div>
        <a href="#" class="btn btn-sm bpb-course-btn align-self-center">Resume</a>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-course-1" aria-valuenow="12" aria-valuemin="0" aria-valuemax="20">
        <div class="progress-bar" style="width: 60%"></div>
      </div>
    </li>
    <li class="list-group-item px-4 py-3">
      <div class="d-flex justify-content-between gap-3 mb-2">
        <div>
          <p class="fw-semibold mb-0" id="bpb-course-2">Design systems in practice</p>
          <p class="small text-body-secondary mb-0">3 of 14 lessons</p>
        </div>
        <a href="#" class="btn btn-sm bpb-course-btn align-self-center">Resume</a>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-course-2" aria-valuenow="3" aria-valuemin="0" aria-valuemax="14">
        <div class="progress-bar" style="width: 21.43%"></div>
      </div>
    </li>
    <li class="list-group-item px-4 py-3">
      <div class="d-flex justify-content-between gap-3 mb-2">
        <div>
          <p class="fw-semibold mb-0" id="bpb-course-3">Accessible color</p>
          <p class="small text-body-secondary mb-0"><span class="badge bg-success-subtle text-success-emphasis me-1">Completed</span>9 of 9 lessons</p>
        </div>
        <a href="#" class="btn btn-sm btn-outline-secondary align-self-center">Certificate</a>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-course-3" aria-valuenow="9" aria-valuemin="0" aria-valuemax="9">
        <div class="progress-bar bg-success" style="width: 100%"></div>
      </div>
    </li>
  </ul>
</div>

Live, scripted and indeterminate progress

Bars that change while you watch: a timer-driven upload with cancel, a reading indicator tied to scroll, an SVG ring, a session countdown and an indeterminate loader. All of it is plain JavaScript on top of Bootstrap classes.

File upload with cancel and a live status

  • setTimeout chain
  • aria-valuenow
  • role="status"
  • progress-bar-animated

Click Start upload, then let it finish or cancel it.

A setTimeout chain stands in for upload events and calls one function that updates the width, aria-valuenow and the megabyte count together. Cancel clears the pending timeout, and the role="status" line announces start, cancel and completion without reading every percent.

View code
<div class="card border-0 shadow-sm bpb-upload">
  <div class="card-body p-4">
    <div class="d-flex align-items-center gap-3 mb-3">
      <span class="bpb-file-icon" aria-hidden="true"><i class="bi bi-file-earmark-zip"></i></span>
      <div class="flex-grow-1 min-w-0">
        <p class="fw-semibold mb-0 text-truncate" id="bpb-up-name">site-backup-oct.zip</p>
        <p class="small text-body-secondary mb-0"><span id="bpb-up-size">0 of 248 MB</span></p>
      </div>
      <span class="small fw-semibold" id="bpb-up-pct">0%</span>
    </div>
    <div class="progress mb-3" id="bpb-up-progress" role="progressbar" aria-labelledby="bpb-up-name" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
      <div class="progress-bar" style="width: 0%"></div>
    </div>
    <p class="small mb-4" id="bpb-up-live" role="status">Ready to upload.</p>
    <div class="d-flex gap-2">
      <button type="button" class="btn btn-primary flex-grow-1 bpb-up-btn" id="bpb-up-start"><i class="bi bi-cloud-arrow-up me-2" aria-hidden="true"></i><span id="bpb-up-start-label">Start upload</span></button>
      <button type="button" class="btn btn-outline-danger bpb-up-btn" id="bpb-up-cancel" disabled>Cancel</button>
    </div>
  </div>
</div>

Reading progress for a scrolling article

  • sticky-top
  • scroll event
  • requestAnimationFrame
  • --bs-progress-bar-transition

Scroll the article to fill the bar.

The bar sits in a sticky header above a scrollable article panel and reads scrollTop against the scrollable height, throttled with requestAnimationFrame. --bs-progress-bar-transition is set to none here, because the default .6s width easing would make the bar lag behind the scroll.

View code
<div class="card border-0 shadow-sm overflow-hidden bpb-read">
  <div class="bpb-read-body" id="bpb-read-body" tabindex="0" aria-label="Article: Why our studio moved to a four-day week">
    <div class="sticky-top bg-body px-4 pt-3 pb-2 border-bottom">
      <div class="d-flex justify-content-between small mb-2">
        <span class="fw-semibold">Field notes</span>
        <span class="text-body-secondary" id="bpb-read-pct">0% read</span>
      </div>
      <div class="progress" id="bpb-read-progress" role="progressbar" aria-label="Reading progress" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100">
        <div class="progress-bar" style="width: 0%"></div>
      </div>
    </div>
    <article class="px-4 py-3">
      <h3 class="h5">Why our studio moved to a four-day week</h3>
      <p class="small text-body-secondary">Ines Varga, 6 min read</p>
      <p>We tried it for one quarter, expecting to roll it back. Twelve people, four client retainers and a product launch in the middle of it all.</p>
      <p>The first month was rough. Meetings that used to fill Fridays slid into Thursday afternoons, and nobody had a clear sense of what could wait until Monday.</p>
      <h4 class="h6 mt-4">What changed first</h4>
      <p>We cut every recurring meeting and only brought back the ones people asked for. Six out of eleven never returned. Status updates moved to a written note on Monday morning.</p>
      <p>Design reviews got shorter because they had to. A reviewer now gets the file a day ahead and comes with comments, not first impressions.</p>
      <h4 class="h6 mt-4">What we measured</h4>
      <p>Billable hours dropped a little. Revisions per project dropped more, and the launch shipped two days early. Sick days fell by almost half compared with the same quarter last year.</p>
      <p>The numbers are small and the sample is one studio, so treat them as a story rather than proof.</p>
      <h4 class="h6 mt-4">Would we do it again</h4>
      <p class="mb-0">Yes, with one rule: Friday is off for everyone at the same time. Staggered days off brought the meetings straight back.</p>
    </article>
  </div>
</div>

Circular progress ring in a card

  • inline SVG
  • pathLength
  • role="progressbar"
  • aria-valuetext
  • card

Click Log a 5 km run.

Bootstrap has no circular progress, so the ring is an inline SVG circle with pathLength="100", which makes stroke-dashoffset equal to 100 minus the percent. The wrapper keeps the same ARIA contract as a .progress bar, and the stroke easing only runs inside prefers-reduced-motion: no-preference.

View code
<div class="card border-0 shadow-sm bpb-ring-card">
  <div class="card-body p-4">
    <div class="row g-4 align-items-center">
      <div class="col-sm-5 d-flex justify-content-center">
        <div class="bpb-ring" id="bpb-ring" role="progressbar" aria-labelledby="bpb-ring-title" aria-valuenow="18" aria-valuemin="0" aria-valuemax="30" aria-valuetext="18 of 30 kilometres">
          <svg viewBox="0 0 120 120" aria-hidden="true" focusable="false">
            <circle class="bpb-ring-track" cx="60" cy="60" r="52"></circle>
            <circle class="bpb-ring-arc" id="bpb-ring-arc" cx="60" cy="60" r="52" pathLength="100" style="stroke-dashoffset: 40"></circle>
          </svg>
          <div class="bpb-ring-label" aria-hidden="true"><span class="fs-3 fw-bold" id="bpb-ring-km">18</span><span class="small text-body-secondary">of 30 km</span></div>
        </div>
      </div>
      <div class="col-sm-7">
        <h3 class="h5 mb-1" id="bpb-ring-title">Weekly running goal</h3>
        <p class="small text-body-secondary mb-3">Mon 27 Oct to Sun 2 Nov</p>
        <ul class="list-unstyled small mb-3">
          <li class="d-flex justify-content-between border-bottom py-1"><span>Tuesday, easy run</span><span class="fw-semibold">8 km</span></li>
          <li class="d-flex justify-content-between border-bottom py-1"><span>Thursday, intervals</span><span class="fw-semibold">10 km</span></li>
        </ul>
        <p class="small mb-3" id="bpb-ring-note" role="status">12 km to go this week.</p>
        <button type="button" class="btn w-100 bpb-ring-btn" id="bpb-ring-log"><i class="bi bi-plus-lg me-1" aria-hidden="true"></i>Log a 5 km run</button>
      </div>
    </div>
  </div>
</div>

Session timeout countdown bar

  • aria-valuetext
  • bg-danger
  • --bs-progress-bar-transition
  • role="status"
  • setTimeout

Click Stay signed in to reset the timer.

A bar that counts down: aria-valuenow is the seconds left, aria-valuetext reads "42 seconds left", and the fill turns red under 15 seconds while the clock text carries the same warning. The live region speaks only at 30 s, 10 s and sign-out, not every tick, and the linear width easing is set only for users without a reduced-motion preference.

View code
<div class="card border-0 shadow-sm bpb-session">
  <div class="card-body p-4">
    <div class="d-flex align-items-start gap-3 mb-3">
      <span class="bpb-session-icon" aria-hidden="true"><i class="bi bi-hourglass-split"></i></span>
      <div>
        <h3 class="h6 mb-1" id="bpb-cd-title">Your session is about to expire</h3>
        <p class="small text-body-secondary mb-0">You will be signed out of Ledgerline in <strong class="text-body" id="bpb-cd-clock">1:00</strong>.</p>
      </div>
    </div>
    <div class="progress mb-2" id="bpb-cd-progress" role="progressbar" aria-labelledby="bpb-cd-title" aria-valuenow="60" aria-valuemin="0" aria-valuemax="60" aria-valuetext="60 seconds left">
      <div class="progress-bar" style="width: 100%"></div>
    </div>
    <p class="visually-hidden" id="bpb-cd-live" role="status"></p>
    <div class="d-flex flex-wrap gap-2 mt-4">
      <button type="button" class="btn btn-dark flex-grow-1 bpb-cd-btn" id="bpb-cd-stay">Stay signed in</button>
      <button type="button" class="btn btn-outline-secondary bpb-cd-btn" id="bpb-cd-out">Sign out now</button>
    </div>
  </div>
</div>

Indeterminate loading bar with a static fallback

  • @keyframes
  • prefers-reduced-motion
  • progress-bar-striped
  • role="progressbar"

Bootstrap documents no indeterminate state, so this one adds it: the wrapper keeps role="progressbar" but drops aria-valuenow, which is how ARIA marks an unknown value. The sliding segment is a custom keyframe inside prefers-reduced-motion: no-preference, and everyone else gets a still, full-width striped bar.

View code
<div class="card border-0 shadow-sm bpb-sync">
  <div class="card-body p-4">
    <div class="d-flex justify-content-between align-items-center mb-1">
      <h3 class="h6 mb-0" id="bpb-sync-title">Syncing mailbox</h3>
      <span class="badge bg-info-subtle text-info-emphasis">In progress</span>
    </div>
    <p class="small text-body-secondary mb-3">Fetching messages from mail.harborline.test. Large inboxes can take a minute.</p>
    <div class="progress bpb-indet" role="progressbar" aria-labelledby="bpb-sync-title" aria-valuemin="0" aria-valuemax="100" aria-valuetext="Working, time remaining unknown">
      <div class="progress-bar progress-bar-striped bpb-indet-bar"></div>
    </div>
    <ul class="list-unstyled small mt-4 mb-0 d-grid gap-2">
      <li class="d-flex align-items-center gap-2"><i class="bi bi-check-circle-fill text-success" aria-hidden="true"></i>Folders found<span class="visually-hidden">, done</span></li>
      <li class="d-flex align-items-center gap-2"><i class="bi bi-arrow-repeat text-info-emphasis" aria-hidden="true"></i>Downloading messages<span class="visually-hidden">, in progress</span></li>
      <li class="d-flex align-items-center gap-2 text-body-secondary"><i class="bi bi-circle" aria-hidden="true"></i>Building search index<span class="visually-hidden">, waiting</span></li>
    </ul>
  </div>
</div>

Theming, vertical bars and dark mode

The --bs-progress-* variables restyle a bar without Sass, a few scoped rules turn it vertical, and the dark color mode recolors the track for free.

Skills card themed with --bs-progress-* variables

  • --bs-progress-bg
  • --bs-progress-bar-bg
  • --bs-progress-border-radius
  • --bs-progress-height
  • --bs-progress-box-shadow

One scoped class reassigns five --bs-progress-* variables, which turns the default blue pill into square terracotta bars on a cream track with no Sass build. The values are out of 10, so aria-valuemax is 10 and aria-valuetext reads "9 out of 10".

View code
<div class="card bpb-skills">
  <div class="card-body p-4">
    <div class="d-flex align-items-center gap-3 mb-4">
      <span class="bpb-skills-mono" aria-hidden="true">MO</span>
      <div>
        <h3 class="h5 mb-0">Mara Okafor</h3>
        <p class="small mb-0 bpb-skills-muted">Product designer, Lisbon</p>
      </div>
    </div>
    <div class="d-grid gap-3">
      <div>
        <div class="d-flex justify-content-between small mb-1"><span id="bpb-sk-1">Interaction design</span><span class="bpb-skills-muted">9 / 10</span></div>
        <div class="progress" role="progressbar" aria-labelledby="bpb-sk-1" aria-valuenow="9" aria-valuemin="0" aria-valuemax="10" aria-valuetext="9 out of 10"><div class="progress-bar" style="width: 90%"></div></div>
      </div>
      <div>
        <div class="d-flex justify-content-between small mb-1"><span id="bpb-sk-2">Prototyping</span><span class="bpb-skills-muted">8 / 10</span></div>
        <div class="progress" role="progressbar" aria-labelledby="bpb-sk-2" aria-valuenow="8" aria-valuemin="0" aria-valuemax="10" aria-valuetext="8 out of 10"><div class="progress-bar" style="width: 80%"></div></div>
      </div>
      <div>
        <div class="d-flex justify-content-between small mb-1"><span id="bpb-sk-3">User research</span><span class="bpb-skills-muted">7 / 10</span></div>
        <div class="progress" role="progressbar" aria-labelledby="bpb-sk-3" aria-valuenow="7" aria-valuemin="0" aria-valuemax="10" aria-valuetext="7 out of 10"><div class="progress-bar" style="width: 70%"></div></div>
      </div>
      <div>
        <div class="d-flex justify-content-between small mb-1"><span id="bpb-sk-4">Front-end code</span><span class="bpb-skills-muted">5 / 10</span></div>
        <div class="progress" role="progressbar" aria-labelledby="bpb-sk-4" aria-valuenow="5" aria-valuemin="0" aria-valuemax="10" aria-valuetext="5 out of 10"><div class="progress-bar" style="width: 50%"></div></div>
      </div>
    </div>
  </div>
</div>

Vertical tank levels with scoped CSS

  • flex-direction: column-reverse
  • --bs-progress-height
  • --bs-progress-bar-transition
  • text-bg-danger

Click Refill tank C.

A scoped class turns the flex track into a tall column with column-reverse, so the fill grows from the bottom and its size goes in height instead of width. The built-in transition only animates width, so the height easing is set through --bs-progress-bar-transition inside a no-preference media query.

View code
<div class="card border-0 shadow-sm bpb-tanks">
  <div class="card-body p-4">
    <h3 class="h6 mb-1">Greenhouse irrigation</h3>
    <p class="small text-body-secondary mb-4">Bay 2, last reading 08:40</p>
    <div class="d-flex justify-content-between gap-2 mb-4">
      <div class="text-center bpb-tank-col">
        <div class="progress bpb-tank mx-auto" role="progressbar" aria-label="Tank A" aria-valuenow="82" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="height: 82%"></div></div>
        <p class="small fw-semibold mt-2 mb-0">Tank A</p>
        <p class="small text-body-secondary mb-0">82%</p>
      </div>
      <div class="text-center bpb-tank-col">
        <div class="progress bpb-tank mx-auto" role="progressbar" aria-label="Tank B" aria-valuenow="64" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="height: 64%"></div></div>
        <p class="small fw-semibold mt-2 mb-0">Tank B</p>
        <p class="small text-body-secondary mb-0">64%</p>
      </div>
      <div class="text-center bpb-tank-col">
        <div class="progress bpb-tank mx-auto" id="bpb-tank-c" role="progressbar" aria-label="Tank C" aria-valuenow="14" aria-valuemin="0" aria-valuemax="100" aria-valuetext="14 percent, low"><div class="progress-bar bg-danger" style="height: 14%"></div></div>
        <p class="small fw-semibold mt-2 mb-0">Tank C</p>
        <p class="small mb-0 text-danger-emphasis fw-semibold" id="bpb-tank-c-val">14%, low</p>
      </div>
      <div class="text-center bpb-tank-col">
        <div class="progress bpb-tank mx-auto" role="progressbar" aria-label="Tank D" aria-valuenow="47" aria-valuemin="0" aria-valuemax="100"><div class="progress-bar" style="height: 47%"></div></div>
        <p class="small fw-semibold mt-2 mb-0">Tank D</p>
        <p class="small text-body-secondary mb-0">47%</p>
      </div>
    </div>
    <button type="button" class="btn btn-outline-dark w-100 bpb-tank-btn" id="bpb-tank-refill"><i class="bi bi-droplet-fill me-1" aria-hidden="true"></i>Refill tank C</button>
    <p class="visually-hidden" id="bpb-tank-live" role="status"></p>
  </div>
</div>

Dark mode render queue

  • data-bs-theme="dark"
  • --bs-secondary-bg
  • text-bg-*
  • progress-bar-animated
  • font-monospace

In the dark color mode the track follows var(--bs-secondary-bg) automatically, so only the fills are themed: a mint accent through --bs-progress-bar-bg with dark label text. The running job keeps animated stripes, and each row repeats its state in a badge.

View code
<div class="card border-secondary-subtle bpb-farm">
  <div class="card-body p-4">
    <div class="d-flex justify-content-between align-items-center mb-4">
      <h3 class="h6 mb-0">Render queue</h3>
      <span class="small text-body-secondary font-monospace">node-03, 2 GPUs</span>
    </div>
    <div class="mb-4">
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span class="font-monospace" id="bpb-job-1">harbor_flythrough_v4</span>
        <span class="badge text-bg-success">Done</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-job-1" aria-valuenow="100" aria-valuemin="0" aria-valuemax="100" aria-valuetext="Done, 100 percent">
        <div class="progress-bar" style="width: 100%">240 / 240 frames</div>
      </div>
    </div>
    <div class="mb-4">
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span class="font-monospace" id="bpb-job-2">atrium_daylight_v2</span>
        <span class="badge text-bg-info">Rendering</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-job-2" aria-valuenow="58" aria-valuemin="0" aria-valuemax="100" aria-valuetext="Rendering, 58 percent">
        <div class="progress-bar progress-bar-striped progress-bar-animated" style="width: 58%">174 / 300</div>
      </div>
    </div>
    <div>
      <div class="d-flex justify-content-between align-items-center small mb-1">
        <span class="font-monospace" id="bpb-job-3">lobby_night_v1</span>
        <span class="badge text-bg-secondary">Queued</span>
      </div>
      <div class="progress" role="progressbar" aria-labelledby="bpb-job-3" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" aria-valuetext="Queued, 0 percent">
        <div class="progress-bar" style="width: 0%"></div>
      </div>
    </div>
  </div>
</div>

How do you create a Bootstrap progress bar?

Load the stylesheet, add a wrapper, nest the bar inside it. In Bootstrap 5.3 that’s most of the job.

  1. Load the Bootstrap stylesheet (5.3.8 is the current release as of October 2026).
  2. Add a div with class progress, plus role="progressbar", an aria-label and the three value attributes.
  3. Nest a div with class progress-bar inside it.
  4. Set the width on that inner bar and mirror the same value in aria-valuenow.
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-sRIl4kxILFvY47J16cr9ZwB07vP4J8+LH7qKQnuqkuIAvNWLzeN8tE5YBujZqJLB" crossorigin="anonymous">

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

According to the Bootstrap docs, the wrapper defines the maximum value of the track, while the inner bar draws the fill and can hold a label.

No script is involved in drawing it. Both classes ship in the compiled stylesheet of the Bootstrap framework, and CSS alone draws the fill.

The skipped native element was a deliberate call. Two plain HTML elements and a few attributes are all the component needs (Bootstrap docs).

Setting the value: width and ARIA attributes

A progress bar carries its value twice. The width on .progress-bar draws the fill, and aria-valuenow on .progress is what a screen reader announces.

Nothing links the two. The 5.3.8 stylesheet source never reads aria-valuenow, so you set both yourself.

Setting the width with inline style or utilities

Inline style accepts any percentage, for example width: 37.5%. The utilities are narrower. Bootstrap’s sizing docs list .w-25, .w-50, .w-75, .w-100 and .w-auto, and nothing in between. Custom CSS works too, which is handy when the value comes from a stylesheet variable.

The 5.3.8 source sets no width on a standalone .progress-bar. A bar with none collapses to the width of its label, or to nothing when it has no label.

The wrapper marks 100% of the track, so width equals value divided by maximum. Say 30 of 80 files have uploaded. The inline width comes out at 37.5%, with aria-valuenow at 30 and aria-valuemax at 80.

Required ARIA attributes in Bootstrap 5.3

Since v5.3.0, role="progressbar" and the value attributes sit on the .progress wrapper, not on the inner bar.

The reason was screen reader behavior. With the ARIA attributes on the inner element, some readers skipped zero-value bars (Bootstrap migration guide).

The wrapper takes the role="progressbar" attribute along with aria-valuenow for the current value, aria-valuemin (usually 0) and aria-valuemax (usually 100). It also needs an accessible name, which comes from aria-label or aria-labelledby.

Skip the name and two bars on the same page sound identical. Give each its own, such as “Upload progress” and “Video conversion”.

The legacy structure keeps working until v6, according to the Bootstrap docs, so old markup does not break inside version 5.

How to change progress bar height, label and color

Height goes on .progress. The label sits inside .progress-bar, and color comes from bg-* or text-bg-* classes. Mixing up which element gets what is the usual mistake.

Height

Set height on the wrapper only. The inner bar resizes with it, and the default is 1rem (Bootstrap docs, v5.3.8).

<div class="progress" role="progressbar" aria-label="Disk usage" aria-valuenow="25" aria-valuemin="0" aria-valuemax="100" style="height: 20px">
  <div class="progress-bar" style="width: 25%"></div>
</div>

The label font is 0.75 times the base size and the wrapper hides overflow. A 1px hairline bar cannot show text at all.

Labels

Put the text between the .progress-bar tags. The bar centers its content and keeps it on one line (white-space: nowrap in the 5.3.8 source).

Overflow is hidden by default, so a label longer than the fill gets cut off. Adding .overflow-visible lets the text spill out, but then it has to pass contrast against the track and the fill both.

Early in a task the fill is narrow, so an in-bar label is the first thing to break. The Bootstrap docs recommend placing the label outside the bar when text can overlap the fill. I’d do that by default.

Colors

bg-* classes color the fill. text-bg-* colors the fill and picks a matching text color in one class.

ClassWhat it setsUse it when
bg-success, bg-info, bg-warning, bg-dangerFill color onlyThe bar has no label
text-bg-success and siblingsFill plus contrasting text colorThe label sits inside the bar
Custom class with a text-* utilityYour own color pairBrand colors outside the theme

The text-bg-* helpers arrived in v5.2.0 and pair each background with a contrasting text color (migration guide). Bootstrap had already raised its contrast ratio from 3:1 to 4.5:1 in v5.0.0.

Custom pairs get no such check. A label on a brand color needs enough color contrast against both the fill and the gray track.

That sounds like a small detail until you look at the numbers. WebAIM’s 2026 Million report found low-contrast text on 83.9% of home pages, the most common failure it detected.

Color also carries no meaning for screen reader users. Put the status in visible text, or in .visually-hidden text, as the docs advise.

Striped and animated progress bars

Stripes come from .progress-bar-striped and motion from .progress-bar-animated. Both go on the inner .progress-bar element.

The stripes are a CSS gradient laid over the bar color, and the gradient’s tile size reads --bs-progress-height. Set the height through that variable on a striped bar, because a plain height on the wrapper leaves the stripe tile at 1rem.

<div class="progress" role="progressbar" aria-label="Importing data" aria-valuenow="75" aria-valuemin="0" aria-valuemax="100" style="--bs-progress-height: 20px">
  <div class="progress-bar progress-bar-striped progress-bar-animated" style="width: 75%"></div>
</div>

The motion comes from a CSS keyframes animation named progress-bar-stripes. It runs at 1s, linear, infinite, and shifts the gradient’s horizontal background position (5.3.8 source).

Because the animation moves the stripe gradient, .progress-bar-animated only shows when .progress-bar-striped sits on the same element.

The 5.3.8 source also has two Sass switches. With $enable-transitions set to false, the keyframes and the animated class are not compiled at all. $enable-reduced-motion, when true, applies animation: none inside a prefers-reduced-motion: reduce media query, so the stripes stay still.

The Bootstrap progress docs page does not mention the reduced-motion rule. You only find it in the source, in scss/_progress.scss.

A misspelling circulates in tutorials: progress-bar-stripped. The 5.3.8 source has no rule for it, so the bar renders as a plain fill.

Reserve animated stripes for a task that is still running. On a bar at 100%, moving stripes suggest work that has already finished.

How do you stack multiple bars in one progress bar?

Stacking takes a .progress-stacked container around several .progress elements. Each segment’s width goes on its own .progress, not on the inner bar.

<div class="progress-stacked">
  <div class="progress" role="progressbar" aria-label="Documents" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
    <div class="progress-bar"></div>
  </div>
  <div class="progress" role="progressbar" aria-label="Photos" aria-valuenow="35" aria-valuemin="0" aria-valuemax="100" style="width: 35%">
    <div class="progress-bar bg-success"></div>
  </div>
  <div class="progress" role="progressbar" aria-label="Backups" aria-valuenow="15" aria-valuemin="0" aria-valuemax="100" style="width: 15%">
    <div class="progress-bar bg-info"></div>
  </div>
</div>

Each segment is a progress bar in its own right, with its own role, value attributes and accessible name. Its aria-valuenow matches its own width rather than a running total (the docs example uses 15, 30 and 20).

The 5.3.8 source explains the width rule. Inside the container, every inner bar is forced to width: 100% of its segment, so the segment’s width is the only one that counts.

Stacked bars tend to break in predictable ways. Segments that add up past 100% get the last one clipped, because the container hides overflow. One shared aria-label on every segment leaves screen reader users unable to tell them apart. And a width on the inner .progress-bar gets ignored, since the docs call for it on the segment.

Before 5.3, the docs stacked bars by putting several .progress-bar elements inside one .progress, and the 4.6 and 5.2 docs both show it. Some tutorials also use “stacked” for separate bars placed in rows, which is a different layout.

Updating a Bootstrap progress bar with JavaScript

Bootstrap ships no script for this, so one small function has to update the width and the ARIA value together. The progress docs have no JavaScript section, and the 5.3.8 stylesheet draws the whole component, which leaves a few lines of plain JavaScript.

function setProgress(wrapper, value, max = 100) {
  const bar = wrapper.querySelector('.progress-bar');
  const percent = (value / max) * 100;

  wrapper.setAttribute('aria-valuenow', value);
  wrapper.setAttribute('aria-valuemax', max);
  bar.style.width = percent + '%';

  if (value >= max) {
    bar.classList.remove('progress-bar-animated');
  }
}

The third argument covers bars whose maximum is not 100. At completion the function also strips the animated class, so a finished bar stops moving.

The bar ships with a width transition (width .6s ease, set by $progress-bar-transition), so each update glides in with no extra code.

Strict CSP is the other case to know about. If a Content Security Policy blocks inline styles, a style attribute in the markup is ignored. Setting element.style.width from script still works, which is the workaround the Bootstrap 3.4.1 docs describe, and the .w-* utilities are unaffected because they live in the stylesheet.

Customizing the Bootstrap progress bar with Sass and CSS variables

To restyle one bar, override a CSS variable on its .progress. To restyle every bar in the project, change the Sass variables before compiling. CSS variables on the component arrived in v5.2.0 (Bootstrap docs).

<div class="progress" role="progressbar" aria-label="Storage used" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="--bs-progress-bar-bg: #6f42c1; --bs-progress-border-radius: 50rem">
  <div class="progress-bar" style="width: 60%"></div>
</div>

Two variables produce a pill-shaped purple bar. Add a bg-* class to the inner bar and the class wins, because utilities are !important by default ($enable-important-utilities is true in 5.3.8).

The documented defaults in Bootstrap 5.3.8 start with a track background of var(--bs-secondary-bg), so it follows the active color mode, and a bar background of $primary, which is #0d6efd. Bar text is $white. The corner radius is var(--bs-border-radius), .375rem out of the box, and the inset shadow is var(--bs-box-shadow-inset).

Sass overrides must sit after the functions import and before the variables import. Once a default variable has been used, it cannot be changed, so a late override does nothing (Bootstrap migration guide).

Stacked bars need the variable on each segment. Every .progress declares the variables itself, so a value set on .progress-stacked never reaches the segments.

Overrides for the rest of the framework follow the same cascade rules, which the guide to overriding Bootstrap CSS walks through.

Which progress bar markup should you use?

For new work, use the Bootstrap 5.3 structure. Older markup only makes sense where a framework upgrade is not planned. And when the task has no measurable end, the native HTML progress element is the better pick.

Bootstrap 3, 4 and 5.3 markup compared

The official Bootstrap 3 and Bootstrap 4 docs both carry an end-of-life banner, and Bootstrap 5.0.0 dropped Internet Explorer 10 and 11 (migration guide). A project that must still serve those browsers stays on an unsupported release.

AspectBootstrap 3.4.1Bootstrap 4.6Bootstrap 5.3
ARIA attributesInner .progress-barInner .progress-bar.progress wrapper
Color classesprogress-bar-success, -info, -warning, -dangerbg-success and siblingsbg-* or text-bg-*
Animated stripes.active on a striped bar.progress-bar-animated.progress-bar-animated
Stacked barsSeveral bars in one .progressSeveral bars in one .progress.progress-stacked around segments
Hidden label text.sr-only.sr-only.visually-hidden

Tutorials mix the generations freely. Some Bootstrap 4 guides tell readers to color bars with background classes, while others still demonstrate progress-bar-success, a Bootstrap 3 class.

Every cell above comes from the official 3.4.1, 4.6 and 5.3 docs, which is the safest place to settle a disagreement.

Bootstrap progress bar versus the HTML progress element

CriterionBootstrap progress barHTML progress element
Accessibility roleAdded with role="progressbar" on .progressImplicit progressbar role (MDN)
Unknown durationNo indeterminate state in the 5.3 docsOmit the value attribute (MDN)
Segments.progress-stackedOne value only
Text on the barLabel inside .progress-barText between the tags is a fallback, not a label (MDN)
Styling hooksClasses and --bs-progress-* variablesVendor pseudo-elements such as ::-webkit-progress-bar

Inside a Bootstrap project, the Bootstrap bar handles anything measured and the native element handles open-ended waits. A page that loads Bootstrap for nothing else can skip the framework and use a hand-built CSS progress bar.

Support is no reason to avoid the native element, which has been available across browsers since July 2015 (MDN). Its look varies by engine, which is why MDN lists separate ::-webkit- and ::-moz- pseudo-elements.

Bootstrap Progress Bar FAQ

Can you make a vertical Bootstrap progress bar?

Not out of the box. The 5.3 docs describe only horizontal bars, with the fill sized by width.

A vertical version needs custom CSS: a tall, narrow wrapper, a column flex direction, and a fill sized by height. The built-in transition targets width only, so you have to add your own height transition.

How do you show file upload progress with a progress bar?

Call the setProgress function from whatever event reports bytes sent. Pass bytes sent as the value and total bytes as the maximum.

The function computes the percentage itself. When the total size is unknown, no percentage exists, and the native HTML progress element without a value attribute fits better.

Which values should a multi-step form progress bar use?

The current step is the value and the number of steps is the maximum. On step 3 of 5, aria-valuenow is 3, aria-valuemax is 5 and the width is 60%.

Show “Step 3 of 5” as text beside the bar. Labels inside a narrow fill get clipped.

Is a spinner better than a progress bar for loading states?

Yes, when completion cannot be measured. The progress component expects a known value, and spinners are a separate component built for open-ended waits.

Under reduced motion, spinners slow down (Bootstrap v5.0.0 migration guide), while animated stripes stop entirely (5.3.8 source).

Testing a Bootstrap Progress Bar With a Screen Reader

A finished Bootstrap progress bar passes when a screen reader announces its accessible name and current value at 0 and 100, plus somewhere in the middle.

Start by inspecting the .progress wrapper for the role, the value attributes and a name. That takes seconds and rules out missing attributes before any listening starts. Then listen at 0, 50 and 100 percent, and repeat after every scripted update.

The scripted pass comes last for a reason. Only a live update shows whether the ARIA value moved with the width.

The cost is manual time, since every change to the markup or the update function needs another listening pass.

This position was verified in October 2026 against Bootstrap 5.3.8. The advice changes if Bootstrap v6 drops the inner-bar ARIA placement, which the Bootstrap progress docs say works only until that release.