core-logo

Bootstrap badges

Bootstrap badges are small count and labeling components.

On this page:



Example

Bootstrap Badges scale to suit the size of the 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="c-badge c-bg-secondary">New</span></h1>
<h2>Example heading <span class="c-badge c-bg-secondary">New</span></h2>
<h3>Example heading <span class="c-badge c-bg-secondary">New</span></h3>
<h4>Example heading <span class="c-badge c-bg-secondary">New</span></h4>
<h5>Example heading <span class="c-badge c-bg-secondary">New</span></h5>
<h6>Example heading <span class="c-badge c-bg-secondary">New</span></h6>

Badges can be used as part of links or buttons to provide a counter.

<button type="button" class="c-btn c-btn-primary">
  Notifications <span class="c-badge c-bg-secondary">4</span>
</button>

Remark that depending on how you use them, badges may be complicated for users of screen readers and related assistive technologies.

Unless the context is clear, consider including additional context with a visually hidden piece of additional text.

<button type="button" class="c-btn c-btn-primary">
  Profile <span class="c-badge c-bg-secondary">9</span>
  <span class="sr-only">unread messages</span>
</button>

Contextual variations

Add any of the below-mentioned classes to modify the presentation of a badge. Please note that when using Bootstrap’s default .c-bg-light, you’ll likely need a text color utility like .c-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="c-badge c-bg-primary">Primary</span>
<span class="c-badge c-bg-secondary">Secondary</span>
<span class="c-badge c-bg-success">Success</span>
<span class="c-badge c-bg-danger">Danger</span>
<span class="c-badge c-bg-warning">Warning</span>
<span class="c-badge c-bg-info">Info</span>
<span class="c-badge c-bg-light c-text-dark">Light</span>
<span class="c-badge c-bg-dark">Dark</span>
Conveying meaning to assistive technologies

Using color to add meaning only provides a visual indication, which will not be conveyed to users of assistive technologies – such as screen readers. Ensure that information denoted by the color is either obvious from the content itself (e.g. the visible text), or is included through alternative means, such as additional text hidden with the .sr-only class.

Pill badges

Apply the .badge-pill modifier class to make badges rounded.

Primary Secondary Success Danger Warning Info Light Dark
<span class="c-badge c-rounded-pill c-bg-primary">Primary</span>
<span class="c-badge c-rounded-pill c-bg-secondary">Secondary</span>
<span class="c-badge c-rounded-pill c-bg-success">Success</span>
<span class="c-badge c-rounded-pill c-bg-danger">Danger</span>
<span class="c-badge c-rounded-pill c-bg-warning">Warning</span>
<span class="c-badge c-rounded-pill c-bg-info">Info</span>
<span class="c-badge c-rounded-pill c-bg-light c-text-dark">Light</span>
<span class="c-badge c-rounded-pill c-bg-dark">Dark</span>

Using the contextual .badge-* classes on an <a> element quickly provide actionable badges with hover and focus states.

<a hred="#" class="c-badge c-bg-primary">Primary</a>
<a hred="#" class="c-badge c-bg-secondary">Secondary</a>
<a hred="#" class="c-badge c-bg-success">Success</a>
<a hred="#" class="c-badge c-bg-danger">Danger</a>
<a hred="#" class="c-badge c-bg-warning">Warning</a>
<a hred="#" class="c-badge c-bg-info">Info</a>
<a hred="#" class="c-badge c-bg-light c-text-dark">Light</a>
<a hred="#" class="c-badge c-bg-dark c-text-white">Dark</a>