Documentation and examples for badges, our small count and labeling component.
Badges scale to match the size of the immediate parent element by using relative font sizing and
em
units.
<h1>Example heading <span class="badge bg-secondary">New</span></h1>
<h2>Example heading <span class="badge bg-secondary">New</span></h2>
<h3>Example heading <span class="badge bg-secondary">New</span></h3>
<h4>Example heading <span class="badge bg-secondary">New</span></h4>
<h5>Example heading <span class="badge bg-secondary">New</span></h5>
<h6>Example heading <span class="badge bg-secondary">New</span></h6>Badges can be used as part of links or buttons to provide a counter.
<button type="button" class="btn btn-primary">
Notifications <span class="badge bg-light">4</span>
</button><span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning">Warning</span>
<span class="badge bg-info">Info</span>
<span class="badge bg-light">Light</span>
<span class="badge bg-dark">Dark</span>
Use the
.badge-pill
modifier class to make badges more rounded (with a larger
border-radius
and additional horizontal
padding
). Useful if you miss the badges from v3.
<span class="badge badge-pill bg-primary">Primary</span>
<span class="badge badge-pill bg-secondary">Secondary</span>
<span class="badge badge-pill bg-success">Success</span>
<span class="badge badge-pill bg-danger">Danger</span>
<span class="badge badge-pill bg-warning">Warning</span>
<span class="badge badge-pill bg-info">Info</span>
<span class="badge badge-pill bg-light">Light</span>
<span class="badge badge-pill bg-dark">Dark</span>
Using the contextual
.badge-*
classes on an
<a>
element quickly provide
actionable
badges with hover and focus states.
<a href="#" class="badge bg-primary">Primary</a>
<a href="#" class="badge bg-secondary-soft">Secondary</a>
<a href="#" class="badge bg-success-soft">Success</a>
<a href="#" class="badge bg-danger-soft">Danger</a>
<a href="#" class="badge bg-warning-soft">Warning</a>
<a href="#" class="badge bg-info-soft">Info</a>
<a href="#" class="badge bg-light-soft">Light</a>
<a href="#" class="badge bg-dark-soft">Dark</a>
Use utilities to modify a
.badge
and position it in the corner of a link or button.
<button type="button" class="btn btn-primary position-relative">
Inbox
<span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-danger">
99+
<span class="visually-hidden">unread messages</span>
</span>
</button>
You can also replace the
.badge
class with a few more utilities without a count for a more generic indicator.
<button type="button" class="btn btn-primary position-relative">
Profile
<span class="position-absolute top-0 start-100 translate-middle p-2 bg-danger border border-light rounded-circle">
<span class="visually-hidden">New alerts</span>
</span>
</button>