Skip to main content
The Badge component is used to highlight key information, display status, or show notification counts with consistent styling.

Basic usage

Variants

Badge supports six visual variants for different semantic meanings.

Sizes

Three size options are available: micro, small, and regular.

With icons

Add visual context with leading icons.

Notification counts

Perfect for displaying unread counts or notification numbers.

Status indicators

Combine with icons for clear status communication.

Accessibility

Provide screen reader text for better accessibility.
The visible text shows “5” while screen readers announce “5 unread messages”.

Complex content

Badges can contain multiple elements.

API reference

Badge

'accent' | 'warning' | 'danger' | 'success' | 'neutral' | 'gradient'
default:"'accent'"
Visual style variant that conveys semantic meaning.
'micro' | 'small' | 'regular'
default:"'small'"
Size of the badge.
ReactNode
Icon element to display before the badge content.
ReactNode
required
Badge content, typically text or numbers.
string
Additional CSS classes to apply.
string
Hidden text for screen readers that provides additional context.