Badges

Bootstrap 5 Badges component

Responsive Badges built with the latest Bootstrap 5. Badges add extra information like count or label to any content. Use counters, icons, or labels. Many examples and easy tutorial.

Documentation and examples for badges, our small count and labeling component.


Basic example

Use .badge class to provide your visitors with highlighted, new or unread items by adding it to links, text navs, and more.

Example heading New

        
            
            <h2>Example heading <span class="badge badge-primary">New</span></h2>
          
        
    

Sizes

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.

Example heading New

Example heading New

Example heading New

Example heading New

Example heading New
Example heading New
        
            
            <h1>Example heading <span class="badge badge-primary">New</span></h1>
            <h2>Example heading <span class="badge badge-primary">New</span></h2>
            <h3>Example heading <span class="badge badge-primary">New</span></h3>
            <h4>Example heading <span class="badge badge-primary">New</span></h4>
            <h5>Example heading <span class="badge badge-primary">New</span></h5>
            <h6>Example heading <span class="badge badge-primary">New</span></h6>
          
        
    

Button

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

        
            
            <button type="button" class="btn btn-primary">
              Notifications<span class="badge badge-danger ms-2">8</span>
            </button>
          
        
    

Note that depending on how they are used, badges may be confusing for users of screen readers and similar assistive technologies. While the styling of badges provides a visual cue as to their purpose, these users will simply be presented with the content of the badge. Depending on the specific situation, these badges may seem like random additional words or numbers at the end of a sentence, link, or button.

Unless the context is clear (as with the “Notifications” example, where it is understood that the “4” is the number of notifications), consider including additional context with a visually hidden piece of additional text.

        
            
            <button type="button" class="btn btn-primary">
              Profile <span class="badge badge-danger ms-2">9</span>
              <span class="visually-hidden">unread messages</span>
            </button>
          
        
    

Colors

Use our badge color classes to quickly change the appearance of a badge.

Primary Secondary Success Danger Warning Info Light Dark
        
            
            <span class="badge badge-primary">Primary</span>
            <span class="badge badge-secondary">Secondary</span>
            <span class="badge badge-success">Success</span>
            <span class="badge badge-danger">Danger</span>
            <span class="badge badge-warning">Warning</span>
            <span class="badge badge-info">Info</span>
            <span class="badge badge-light">Light</span>
            <span class="badge badge-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 .visually-hidden class.


Pills

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 badge-primary">Primary</span>
          <span class="badge rounded-pill badge-secondary">Secondary</span>
          <span class="badge rounded-pill badge-success">Success</span>
          <span class="badge rounded-pill badge-danger">Danger</span>
          <span class="badge rounded-pill badge-warning">Warning</span>
          <span class="badge rounded-pill badge-info">Info</span>
          <span class="badge rounded-pill badge-light">Light</span>
          <span class="badge rounded-pill badge-dark">Dark</span>
          
        
    

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 badge-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>
          
        
    

With avatar

        
            
          <div class="d-inline-flex position-relative">
            <span class="position-absolute top-0 start-100 translate-middle p-1 bg-danger border border-light rounded-circle">
              <span class="visually-hidden">New alerts</span>
            </span>
            <img class="rounded-4 shadow-4" src="https://mdbootstrap.com/img/Photos/Avatars/man2.jpg" alt="Avatar" style="width: 50px; height: 50px;">
          </div>
          
        
    

Icon notifications

You can use our icons and .badge-notification class to create a facebook-like notification.

        
            
            <a href="">
              <i class="fas fa-envelope fa-lg"></i>
              <span class="badge bg-danger badge-dot"></span>
            </a>

            <a href="">
              <i class="fas fa-envelope fa-lg"></i>
              <span class="badge rounded-pill badge-notification bg-danger">1</span>
            </a>

            <a href="">
              <i class="fas fa-envelope fa-lg"></i>
              <span class="badge rounded-pill badge-notification bg-danger">999+</span>
            </a>
          
        
    

Icon inside

You can place an icon inside the badge. Read icons docs to see all the available icons.

        
            
  
            <div class="badge badge-primary p-3 rounded-4">
              <i class="fas fa-chart-pie"></i>
            </div>
  
            
        
    

It composes nicely inside of the section with features.

Tutorials

Dozens of free tutorials to help you discover the full potential of MDB.

Learn more

Integrations

MDB is integrated with all major technologies and tools.

Learn more

Backend friendly

MDB is designed to be seamlessly integrated and used with the backend.

Learn more

Support and community

The MDB team and our global community are there to support you.

Learn more
        
            
  
            <section class="mb-5">
              <div class="row gx-lg-5">
                <div class="col-lg-6 mb-5">
                  <div class="d-flex align-items-start">
                    <div class="flex-shrink-0">
                      <div class="p-3 badge-primary rounded-4">
                        <i class="fas fa-cloud-upload-alt fa-lg text-primary fa-fw"></i>
                      </div>
                    </div>
                    <div class="flex-grow-1 ms-4">
                      <p class="fw-bold mb-1">Tutorials</p>
                      <p class="text-muted mb-1">
                        Dozens of free tutorials to help you discover the full potential of MDB.
                      </p>
                      <small><a href="">Learn more</a></small>
                    </div>
                  </div>
                </div>
    
                <div class="col-lg-6 mb-5">
                  <div class="d-flex align-items-start">
                    <div class="flex-shrink-0">
                      <div class="p-3 badge-primary rounded-4">
                        <i class="fas fa-database fa-lg text-primary fa-fw"></i>
                      </div>
                    </div>
                    <div class="flex-grow-1 ms-4">
                      <p class="fw-bold mb-1">Integrations</p>
                      <p class="text-muted mb-1">
                        MDB is integrated with all major technologies and tools.
                      </p>
                      <small><a href="">Learn more</a></small>
                    </div>
                  </div>
                </div>
    
                <div class="col-lg-6 mb-5">
                  <div class="d-flex align-items-start">
                    <div class="flex-shrink-0">
                      <div class="p-3 badge-primary rounded-4">
                        <i class="fas fa-stream fa-lg text-primary fa-fw"></i>
                      </div>
                    </div>
                    <div class="flex-grow-1 ms-4">
                      <p class="fw-bold mb-1">Backend friendly</p>
                      <p class="text-muted mb-1">
                        MDB is designed to be seamlessly integrated and used with the backend.
                      </p>
                      <small><a href="">Learn more</a></small>
                    </div>
                  </div>
                </div>
    
                <div class="col-lg-6 mb-5">
                  <div class="d-flex align-items-start">
                    <div class="flex-shrink-0">
                      <div class="p-3 badge-primary rounded-4">
                        <i class="fas fa-copy fa-lg text-primary fa-fw"></i>
                      </div>
                    </div>
                    <div class="flex-grow-1 ms-4">
                      <p class="fw-bold mb-1">Support and community</p>
                      <p class="text-muted mb-1">
                        The MDB team and our global community are there to support you.
                      </p>
                      <small><a href="">Learn more</a></small>
                    </div>
                  </div>
                </div>
    
              </div>
            </section>
  
            
        
    

Badges - API


CSS variables

As part of MDB’s evolving CSS variables approach, badge now use local CSS variables for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.

Badges CSS variables are in different classes which belong to this component. To make it easier to use them, you can find below all of the used CSS variables.

        
            
        // .badge
        --#{$prefix}badge-padding-x: #{$badge-padding-x};
        --#{$prefix}badge-padding-y: #{$badge-padding-y};
        @include rfs($badge-font-size, --#{$prefix}badge-font-size);
        --#{$prefix}badge-font-weight: #{$badge-font-weight};
        --#{$prefix}badge-color: #{$badge-color};
        --#{$prefix}badge-border-radius: #{$badge-border-radius};

        // .badge-dot
        --#{$prefix}badge-border-radius: #{$badge-dot-border-radius};
        --#{$prefix}badge-height: #{$badge-dot-height};
        --#{$prefix}badge-width: #{$badge-dot-width};
        --#{$prefix}badge-margin-left: #{$badge-dot-margin-left};

        // .badge-notification
        --#{$prefix}badge-font-size: #{$badge-notification-font-size};
        --#{$prefix}badge-padding-x: #{$badge-notification-padding-x};
        --#{$prefix}badge-padding-y: #{$badge-notification-padding-y};
        --#{$prefix}badge-margin-top: #{$badge-notification-margin-top};
        --#{$prefix}badge-margin-left: #{$badge-notification-margin-left};
        
        
    

SCSS variables

        
            
        $badge-font-size: 0.75em;
        $badge-font-weight: $font-weight-bold;
        $badge-color: $white;
        $badge-padding-y: 0.35em;
        $badge-padding-x: 0.65em;
        $badge-border-radius: 0.27rem;

        $badge-dot-border-radius: 4.5px;
        $badge-dot-height: 9px;
        $badge-dot-width: $badge-dot-height;
        $badge-dot-margin-left: -0.3125rem;

        $badge-notification-font-size: 0.6rem;
        $badge-notification-margin-top: -0.1rem;
        $badge-notification-margin-left: -0.5rem;
        $badge-notification-padding-y: 0.2em;
        $badge-notification-padding-x: 0.45em;