Badges
Documentation and examples for badges, our small count and labeling component.
Read the official
Bootstrap Documentation for a full list of
instructions and other options.
Example#
Badges scale to match the size of the immediate parent element by using relative font sizing and
em units.
Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
<h1>Example heading <span class="badge text-bg-secondary">New</span></h1>
<h2>Example heading <span class="badge text-bg-secondary">New</span></h2>
<h3>Example heading <span class="badge text-bg-secondary">New</span></h3>
<h4>Example heading <span class="badge text-bg-secondary">New</span></h4>
<h5>Example heading <span class="badge text-bg-secondary">New</span></h5>
<h6>Example heading <span class="badge text-bg-secondary">New</span></h6>Badges can be used as part of links or buttons to provide a counter & notifications.
<button type="button" class="btn btn-primary">
Message
<span class="badge bg-white text-primary ms-1">4</span>
<span class="visually-hidden">unread messages</span>
</button>
<button type="button" class="btn btn-secondary text-nowrap d-inline-flex position-relative">
Badge
<span
class="position-absolute top-0 start-100 badge text-bg-primary badge-notifications"
>12</span
>
<span class="visually-hidden">unread notifications</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block">
<span class="icon-base ri ri-notification-4-line icon-sm"></span>
<span class="badge rounded-pill text-bg-danger badge-notifications">10</span>
<span class="visually-hidden">unread notifications</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block">
<span class="icon-base ri ri-facebook-fill icon-sm""></span>
<span class="badge rounded-pill bg-danger badge-dot badge-notifications"></span>
<span class="visually-hidden">notifications</span>
</button><button type="button" class="btn btn-primary">
Message
<span class="badge bg-white text-primary ms-1">4</span>
<span class="visually-hidden">unread messages</span>
</button>
<button type="button" class="btn btn-label-secondary text-nowrap d-inline-block position-relative">
Badge
<span class="badge text-bg-secondary position-absolute top-0 start-100 translate-middle">12</span>
<span class="visually-hidden">unread notifications</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block">
<span class="icon-base ri ri-notification-4-line"></span>
<span class="badge rounded-pill bg-danger badge-notifications">10</span>
<span class="visually-hidden">unread notifications</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block">
<span class="icon-base ri ri-facebook-fill"></span>
<span class="badge rounded-pill bg-danger badge-dot badge-notifications"></span>
<span class="visually-hidden">notifications</span>
</button>Basic Badge#
Add any of the below mentioned modifier classes to change the appearance of a badge.
Primary
Secondary
Success
Danger
Warning
Info
Dark
<span class="badge text-bg-primary">Primary</span>
<span class="badge text-bg-secondary">Secondary</span>
<span class="badge text-bg-success">Success</span>
<span class="badge text-bg-danger">Danger</span>
<span class="badge text-bg-warning">Warning</span>
<span class="badge text-bg-info">Info</span>
<span class="badge text-bg-dark">Dark</span>| Class | Value |
|---|---|
class="badge text-bg-{value}"
|
primary | secondary | success | danger | warning | info | dark |
Label Badge#
Badges with light background color. Replace the default modifier classes with the
.bg-label-{value}.
Primary
Secondary
Success
Danger
Warning
Info
Dark
<span class="badge bg-label-primary">Primary</span>
<span class="badge bg-label-secondary">Secondary</span>
<span class="badge bg-label-success">Success</span>
<span class="badge bg-label-danger">Danger</span>
<span class="badge bg-label-warning">Warning</span>
<span class="badge bg-label-info">Info</span>
<span class="badge bg-label-dark">Dark</span>| Class | Value |
|---|---|
class="badge bg-label-{value}"
|
primary | secondary | success | danger | warning | info | dark |
Pill Badges#
Use the .rounded-pill modifier class to make badges more rounded (with a larger
border-radius and additional horizontal padding).
You can also use .rounded-pill class with .bg-label-{value}.
Primary
Secondary
Success
Danger
Warning
Info
Dark
Primary
Secondary
Success
Danger
Warning
Info
Dark
<p>
<span class="badge rounded-pill text-bg-primary">Primary</span>
<span class="badge rounded-pill text-bg-secondary">Secondary</span>
<span class="badge rounded-pill text-bg-success">Success</span>
<span class="badge rounded-pill text-bg-danger">Danger</span>
<span class="badge rounded-pill text-bg-warning">Warning</span>
<span class="badge rounded-pill text-bg-info">Info</span>
<span class="badge rounded-pill text-bg-dark">Dark</span>
</p>
<p>
<span class="badge rounded-pill bg-label-primary">Primary</span>
<span class="badge rounded-pill bg-label-secondary">Secondary</span>
<span class="badge rounded-pill bg-label-success">Success</span>
<span class="badge rounded-pill bg-label-danger">Danger</span>
<span class="badge rounded-pill bg-label-warning">Warning</span>
<span class="badge rounded-pill bg-label-info">Info</span>
<span class="badge rounded-pill bg-label-dark">Dark</span>
</p>
<p>
<span class="badge rounded-pill badge-outline-primary">Primary</span>
<span class="badge rounded-pill badge-outline-secondary">Secondary</span>
<span class="badge rounded-pill badge-outline-success">Success</span>
<span class="badge rounded-pill badge-outline-danger">Danger</span>
<span class="badge rounded-pill badge-outline-warning">Warning</span>
<span class="badge rounded-pill badge-outline-info">Info</span>
<span class="badge rounded-pill badge-outline-dark">Dark</span>
</p>Links#
Using the contextual .text-bg-{value} classes inside an <a> element quickly
provide actionable badges.
<a href="javascript:void(0)"><span class="badge text-bg-primary">Primary</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-secondary">Secondary</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-success">Success</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-danger">Danger</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-warning">Warning</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-info">Info</span></a>
<a href="javascript:void(0)"><span class="badge text-bg-dark">Dark</span></a>Button with Badges#
Badges can be used as part of links or buttons to provide a counter. Style button with badges with
.bg-label-{value}.
<p>
<button type="button" class="btn btn-primary me-4">
Text
<span class="badge bg-white text-primary ms-1">4</span>
</button>
<button type="button" class="btn btn-primary me-4">
Text
<span class="badge bg-secondary rounded-pill ms-1">4</span>
</button>
</p>
<p>
<button type="button" class="btn btn-label-primary me-4">
Text
<span class="badge bg-white text-primary ms-1">4</span>
</button>
<button type="button" class="btn btn-label-primary me-4">
Text
<span class="badge bg-secondary rounded-pill ms-1">4</span>
</button>
</p>
<p>
<button type="button" class="btn btn-outline-primary me-4">
Text
<span class="badge ms-1">4</span>
</button>
<button type="button" class="btn btn-outline-primary me-4">
Text
<span class="badge rounded-pill ms-1">4</span>
</button>
</p>Badge Circle & Square#
Make circle & square badge by using .badge-center class, use .rounded-pills class
for circle badge.
You can also use .bg-label-{value} and .badge-outline-{value} style with this.
Basic
1
1
Label
1
1
<div class="row row-bordered g-0">
<div class="col-xl-6 p-6">
<h6>Basic</h6>
<div class="demo-inline-spacing">
<p>
<span class="badge badge-center rounded-pill text-bg-primary">1</span>
<span class="badge badge-center rounded-pill text-bg-secondary"><i class='icon-base ri ri-star-line'></i></span>
</p>
<p>
<span class="badge badge-center text-bg-primary">1</span>
<span class="badge badge-center text-bg-secondary"><i class='icon-base ri ri-star-line'></i></span>
</p>
</div>
</div>
<div class="col-xl-6 p-6">
<h6>Label</h6>
<div class="demo-inline-spacing">
<p>
<span class="badge badge-center rounded-pill bg-label-primary">1</span>
<span class="badge badge-center rounded-pill bg-label-secondary"><i class='icon-base ri ri-star-line'></i></span>
</p>
<p>
<span class="badge badge-center bg-label-primary">1</span>
<span class="badge badge-center bg-label-secondary"><i class='icon-base ri ri-star-line'></i></span>
</p>
</div>
</div>
</div>| Class | Value |
|---|---|
class="badge badge-center text-bg-{value}"
|
primary | secondary | success | danger | warning | info | dark |
Dots Style#
Use class .badge-dot to create dot style badge.
Primary
Secondary
Success
Danger
Warning
Info
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-primary me-1"></span> Primary
</div>
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-secondary me-1"></span> Secondary
</div>
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-success me-1"></span> Success
</div>
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-danger me-1"></span> Danger
</div>
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-warning me-1"></span> Warning
</div>
<div class="d-flex align-items-center lh-1 me-4">
<span class="badge badge-dot text-bg-info me-1"></span> Info
</div>Notifications#
Use class .badge-notifications for notifications badges. You can also create dot style
notifications by using .badge-dot.
Style notifications badges with .bg-label-{value}
.
<button type="button" class="btn text-nowrap d-inline-block me-4">
<span class="icon-base ri ri-mail-line icon-sm"></span>
<span class="badge text-bg-primary badge-notifications">6</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block me-4">
<span class="icon-base ri ri-twitter-fill icon-sm"></span>
<span class="badge rounded-pill bg-label-info badge-notifications">5</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block me-4">
<span class="icon-base ri ri-notification-4-line icon-sm"></span>
<span class="badge rounded-pill text-bg-danger badge-notifications">10</span>
</button>
<button type="button" class="btn text-nowrap d-inline-block me-4">
<span class="icon-base ri ri-facebook-fill icon-sm"></span>
<span class="badge rounded-pill text-bg-danger badge-dot badge-notifications"></span>
</button>Buttons with Badges Notifications#
Use utilities to modify a .badge and position it in the corner of a link or button.
<button type="button" class="btn btn-label-primary text-nowrap d-inline-flex position-relative me-4">
Badge
<span class="position-absolute top-0 start-100 translate-middle badge text-bg-primary">2</span>
</button>
<button type="button" class="btn btn-warning text-nowrap d-inline-flex position-relative me-4">
Label Badge
<span class="position-absolute top-0 start-100 translate-middle badge bg-label-warning border border-warning">2</span>
</button>
<button type="button" class="btn btn-label-info text-nowrap d-inline-flex position-relative me-4">
Pill
<span class="position-absolute top-0 start-100 translate-middle badge rounded-pill text-bg-info">2</span>
</button>
<button type="button" class="btn btn-label-danger text-nowrap d-inline-flex position-relative">
Dot
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot border border-2 p-2 bg-danger"></span>
</button>Badges Position#
You can use position utilities with .badge class like top-*, start-*, etc...
4
4
4
4
<button type="button" class="btn btn-label-primary text-nowrap d-inline-flex position-relative me-4">
Badge
<span class="position-absolute top-0 start-100 translate-middle badge text-bg-primary">2</span>
</button>
<button type="button" class="btn btn-warning text-nowrap d-inline-flex position-relative me-4">
Label Badge
<span class="position-absolute top-0 start-100 translate-middle badge bg-label-warning border border-warning">2</span>
</button>
<button type="button" class="btn btn-label-info text-nowrap d-inline-flex position-relative me-4">
Pill
<span class="position-absolute top-0 start-100 translate-middle badge rounded-pill text-bg-info">2</span>
</button>
<button type="button" class="btn btn-label-danger text-nowrap d-inline-flex position-relative">
Dot
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot border border-2 p-2 bg-danger"></span>
</button>Badges Shapes#
Using rounded-* utilities for avatar & .badge-dot class for notification
9
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar">
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot rounded-pill text-bg-primary"></span>
</div>
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar" class="rounded-1">
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot border rounded-pill text-bg-primary"></span>
</div>
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar" class="rounded-2">
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot p-2 rounded-pill text-bg-primary"></span>
</div>
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar" class="rounded">
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot rounded-pill text-bg-primary"></span>
</div>
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar" class="rounded-3">
<span class="position-absolute top-0 start-100 translate-middle badge badge-dot p-2 border border-2 rounded-pill text-bg-primary"></span>
</div>
<div class="avatar d-inline-flex position-relative me-4">
<img src="assets/img/avatars/1.png" alt="Avatar" class="rounded-circle">
<span class="position-absolute top-0 start-100 translate-middle badge border rounded-pill text-bg-primary">9</span>
</div>