Bootstrap 5 Badges
Badges
Bootstrap badge is small count and labeling components.
🤖 Looking for the LLM-optimized version?View llm.md
Other frameworks
CoreUI components are available as native Angular, React, and Vue components. To learn more please visit the following pages.
Examples
Bootstrap badge scale to suit the size of the parent element by using relative font sizing andem
units.
Headings
Example headingNew
Example headingNew
Example headingNew
Example headingNew
Example headingNew
Example headingNew
<h1>Example heading<spanclass="badge text-bg-secondary">New</span></h1><h2>Example heading<spanclass="badge text-bg-secondary">New</span></h2><h3>Example heading<spanclass="badge text-bg-secondary">New</span></h3><h4>Example heading<spanclass="badge text-bg-secondary">New</span></h4><h5>Example heading<spanclass="badge text-bg-secondary">New</span></h5><h6>Example heading<spanclass="badge text-bg-secondary">New</span></h6>
Buttons
Badges can be used as part of links or buttons to provide a counter.
<buttontype="button"class="btn btn-primary"> Notifications<spanclass="badge text-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.
Positioned
Use utilities to modify a.badge
and position it in the corner of a link or button.
<buttontype="button"class="btn btn-primary position-relative"> Inbox<spanclass="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-danger"> 99+<spanclass="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.
<buttontype="button"class="btn btn-primary position-relative"> Profile<spanclass="position-absolute top-0 start-100 translate-middle p-2 bg-danger border border-light rounded-circle"><spanclass="visually-hidden">New alerts</span></span></button>
Contextual variations
Add any of the below-mentioned classes to modify the presentation of a badge. Please note that when using CoreUI for 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 butbackground-color
.
<spanclass="badge text-bg-primary">Primary</span><spanclass="badge text-bg-secondary">Secondary</span><spanclass="badge text-bg-success">Success</span><spanclass="badge text-bg-danger">Danger</span><spanclass="badge text-bg-warning">Warning</span><spanclass="badge text-bg-info">Info</span><spanclass="badge text-bg-light">Light</span><spanclass="badge text-bg-dark">Dark</span>
Conveying meaning to assistive technologies
Relying on color to convey meaning creates a visual cue that assistive technologies, like screen readers, cannot perceive. It's essential that any information represented by color is either apparent from the content itself (e.g., the visible text) or supplemented by alternative methods, such as extra text using the.visually-hidden
class.
Pill badges
Apply the.rounded-pill
modifier class to make badges rounded.
<spanclass="badge rounded-pill text-bg-primary">Primary</span><spanclass="badge rounded-pill text-bg-secondary">Secondary</span><spanclass="badge rounded-pill text-bg-success">Success</span><spanclass="badge rounded-pill text-bg-danger">Danger</span><spanclass="badge rounded-pill text-bg-warning">Warning</span><spanclass="badge rounded-pill text-bg-info">Info</span><spanclass="badge rounded-pill text-bg-light">Light</span><spanclass="badge rounded-pill text-bg-dark">Dark</span>
Customizing
CSS variables
Badges use local CSS variables on.badge
for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.
--cui-badge-padding-x:#{$badge-padding-x};--cui-badge-padding-y:#{$badge-padding-y};@include rfs($badge-font-size,--cui-badge-font-size);--cui-badge-font-weight:#{$badge-font-weight};--cui-badge-color:#{$badge-color};--cui-badge-border-radius:#{$badge-border-radius};
SASS variables
$badge-font-size:.75em;$badge-font-weight:$font-weight-bold;$badge-color:$white;$badge-padding-y:.35em;$badge-padding-x:.65em;$badge-border-radius:var(--#{$prefix}border-radius);$badge-font-size-sm:.65em;$badge-padding-y-sm:.3em;$badge-padding-x-sm:.5em;
CoreUI vs Bootstrap
While this Badge component is fully compatible with Bootstrap and follows its core principles, CoreUI delivers a more complete solution for modern app development.
What sets CoreUI apart from Bootstrap?
- ✅Fully compatible with Bootstrap – Built directly on Bootstrap, all classes and behaviors work as expected.
- 🧠Framework-native versions – CoreUI provides dedicated libraries forReact.js,Vue.js, andAngular, unlike Bootstrap which relies on third-party plugins for JavaScript frameworks.
- 👨💻Maintained by a full-time team – CoreUI is developed as a professional product, not a volunteer-driven project.
- 📦More built-in components – Includes additional ready-to-use components like range sliders, multi-selects, steppers, etc.
- 🛠️Sass Modules support today – CoreUI already supports Sass Modules, which are planned for Bootstrap 6.
- 🌍Better LTR/RTL support – Uses modern CSS logical properties for seamless bidirectional layout support.
- 🔒LTS (Long-Term Support) – Bootstrap now offers LTS only via paid third parties like HeroDevs, while CoreUI continues to offer long-term support natively and for free.
Whether you’re building internal tools, dashboards, or SaaS platforms — CoreUI combines the familiarity of Bootstrap with a more powerful, scalable, and production-ready ecosystem.
👉Explore CoreUI Bootstrap Components
👉Compare CoreUI vs Bootstrap