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.

Primary Secondary Success Danger Warning Info Light Dark
<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.

Primary Secondary Success Danger Warning Info Light Dark
<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.

Primary Secondary Success Warning Danger
Primary Secondary Success Warning Danger
<!-- 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>