Badge
Inline labels for status, categories, and metadata -- 11 color variants, 4 sizes, icons, pill/rounded shapes, and stroke outlines.
Use the <Badge> component to tag content with status indicators, category labels, or version markers. Badges render as compact inline elements, so you can drop them into running text or stack them in a layout.
Basic Badge
A simple badge with default styling:
Default<Badge>Default</Badge>Colors
Badges come in 11 color variants to convey different meanings:
<Badge color="gray">Gray</Badge>
<Badge color="blue">Blue</Badge>
<Badge color="green">Green</Badge>
<Badge color="yellow">Yellow</Badge>
<Badge color="orange">Orange</Badge>
<Badge color="red">Red</Badge>
<Badge color="purple">Purple</Badge>Surface Colors
For badges that adapt to the page background:
<Badge color="white">White</Badge>
<Badge color="surface">Surface</Badge>Destructive Colors
For warning or error states:
<Badge color="white-destructive">White Destructive</Badge>
<Badge color="surface-destructive">Surface Destructive</Badge>With Icons
Add icons to make badges more descriptive:
<Badge icon="circle-check" color="green">Verified</Badge>
<Badge icon="star" color="yellow">Featured</Badge>
<Badge icon="bolt" color="purple">New</Badge>
<Badge icon="clock" color="blue">Pending</Badge>Icon Types
Specify a different icon style using iconType:
<Badge icon="star" iconType="solid" color="yellow">Solid</Badge>
<Badge icon="star" iconType="regular" color="yellow">Regular</Badge>
<Badge icon="star" iconType="duotone" color="yellow">Duotone</Badge>
<Badge icon="github" iconType="brands" color="gray">GitHub</Badge>Sizes
Four sizes are available to fit different contexts:
<Badge size="xs" color="blue">Extra Small</Badge>
<Badge size="sm" color="blue">Small</Badge>
<Badge size="md" color="blue">Medium</Badge>
<Badge size="lg" color="blue">Large</Badge>Shapes
Choose between rounded corners or pill shape:
<Badge shape="rounded" color="purple">Rounded</Badge>
<Badge shape="pill" color="purple">Pill</Badge>Stroke Variant
Use outlined badges for a lighter visual weight:
<Badge stroke color="blue">Outlined Blue</Badge>
<Badge stroke color="green">Outlined Green</Badge>
<Badge stroke color="red">Outlined Red</Badge>
<Badge stroke color="purple">Outlined Purple</Badge>Disabled State
Reduce opacity for inactive badges:
<Badge disabled color="gray">Inactive</Badge>
<Badge disabled color="blue">Disabled</Badge>Inline Usage
Badges work inline with text. This feature requires a Premium subscription. You can also mark items as New or Deprecated.
This feature requires a <Badge color="orange" size="sm">Premium</Badge> subscription.
You can also mark items as <Badge color="green" size="sm">New</Badge> or
<Badge color="red" size="sm">Deprecated</Badge>.Props
Color variant: gray, blue, green, yellow, orange, red, purple, white, surface, white-destructive, surface-destructive.
Badge size: xs, sm, md, lg.
Badge shape: rounded, pill.
Font Awesome icon name.
Icon style: regular, solid, light, thin, sharp-solid, duotone, brands.
Display as outlined badge with transparent background.
Reduce opacity to indicate inactive state.
Additional CSS classes for custom styling.