Skip to main content

Components

Badge

Badge is a non-interactive component that displays status with or without a number. Use Tag if you want text instead of a number.

Use Badge when

  • displaying numbers that show the count of new messages, notifications or tasks
  • indicating status using a circular marker, such as showing whether a person is busy, away or active

Avoid Badge when

  • text is needed, use Tag instead
  • interactive actions are required, use Chip or Button instead

Examples

Colours and variants

All colours in your theme can be used with Badge. The component comes in two variants: base and tinted.

Next to text

Badge can be placed next to other text or components.

Floating

Badge can be placed floating above other elements.

Without text

Badge can be used without text inside it, but it must then have accompanying text next to it. Information should not be communicated through colour or shape alone.1

Guidelines

Use Badge to draw attention to statuses, notifications or numbers.

Text

This component is not intended for text. If you need to display words or short phrases, use Tag instead.

Edit this page on github.com (opens in a new tab)