Documentation
Badges
Documentation and examples for badges, our small count and labeling component.
Examples
Badges scale to match the size of the immediate parent element by using relative font sizing and em units. As of v5, badges no longer have focus or hover styles for links.
Heading
Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
<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>
Buttons
<button type="button" class="btn btn-primary">
Notifications<span class="badge bg-secondary">4</span>
</button>
Positioned
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>
Background colors
Use our background utility classes to quickly change the appearance of a badge. Please note that when using Bootstrap’s default .bg-light, you’ll likely need a text color utility like .text-dark for proper styling. This is because background utilities do not set anything but background-color.
<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 text-dark"> Warning </span>
<span class="badge bg-info text-dark"> Info </span>
<span class="badge bg-light text-dark"> Light </span>
<span class="badge bg-dark"> Dark </span>
Pill badges
Use the .rounded-pill utility class to make badges more rounded with a larger border-radius.
<span class="badge rounded-pill bg-primary"> Primary </span>
<span class="badge rounded-pill bg-secondary">Secondary </span>
<span class="badge rounded-pill bg-success"> Success </span>
<span class="badge rounded-pill bg-danger"> Danger </span>
<span class="badge rounded-pill bg-warning text-dark"> Warning </span>
<span class="badge rounded-pill bg-info text-dark"> Info </span>
<span class="badge rounded-pill bg-light text-dark"> Light </span>
<span class="badge rounded-pill bg-dark"> Dark </span>
Pill custom badges
Use the .rounded-pill & iq-custom-badge utility class to make badges more rounded with a larger border-radius and button at end on pills.
<!-- Rounded icon badge -->
<span class="bg-soft-primary rounded-pill iq-custom-badge">
Primary
<button class="btn btn-primary btn-sm rounded-pill iq-cancel-btn">
<svg class="icon-14" width="14" height="14" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path>
</svg>
</button>
</span>
<!-- Normal icon badge -->
<span class="bg-soft-secondary rounded iq-custom-badge">
Secondary
<button class="btn btn-secondary btn-sm rounded iq-cancel-btn">
<svg class="icon-14" width="14" height="14" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"></path>
</svg>
</button>
</span>