Badge
A non-interactive label used to highlight short, scannable information (a status, a category tag, or a count) in the smallest possible footprint.
When to use
- Show a status, such as
Succeeded,Failed,Pending, orBeta. - Tag a list item, a table row, or a card with a category.
- Show a count, such as
12 new, with brief context. - Prefer
ButtonorAnchorwhen the label must respond to a click. To give a link the look of a badge, see Polymorphism. - Prefer
Kbdfor a keyboard key or a shortcut. - Prefer
MultiSelectfor tags that the user picks and removes.
When not to use
- For long-form text. Keep labels to one or two short words.
- As the sole signal of meaning. Pair color with a label or icon so the distinction works without color (color blindness, monochrome themes).
Choosing a color
Prefer functional colors (success, warning, danger, info, accent, neutral) for status meaning so theming stays coherent. Reach for named hues only when the badge's semantic role isn't already covered.
Every color, with and without an icon:
Polymorphism
To render something else as a Badge, use the asChild prop to compose. This is useful when you want to splat the Badge styling onto a react-router Link.
API Reference
Badge
All props from span, plus: