Badges
Overview
Badges are compact visual indicators used to label, annotate, or highlight the status of an item. They provide supplemental information without interrupting the user flow and are commonly used to convey counts, states, or classifications.
Badges are decorative and informational, not interactive. They should be used sparingly to avoid visual noise and maintain clarity.
Benefits theme only
.badge and .icon-tile exist in the benefits theme only — neither is in the employee stylesheet. An employee-app surface that needs a status pill requires the styles to be created in that theme first; don't assume these classes are available there.
Badges carry their meaning entirely in a colored fill with no border, so they lose all visual distinction when printed — the print stylesheet strips backgrounds and forces black text. Where the distinction has to survive black-and-white, use an outline label instead, which keeps its border in print.
Guidelines
Dos
- Use badges to display status, category, or count-based information.
- Use badges as supplementary indicators, not primary content.
- Group multiple badges using a
badge-containerto ensure proper alignment and spacing. - Use color intentionally to communicate meaning.
- Keep badge text short and scannable (typically one word or a number).
Don’ts
- Don’t use badges as interactive elements or actions.
- Don’t overload interfaces with excessive badges.
- Don’t use badges to replace critical messaging or alerts.
- Don’t place badges where they compete with primary actions.
- Don’t use custom colors outside the approved badge variants.
Variants
| Variant | Description | Example Use |
|---|---|---|
| Default | Neutral badge for general labeling | Labels, metadata |
| Primary | Brand-emphasized badge | Featured, highlighted states |
| Success | Positive or completed status | Active, Approved |
| Danger | Critical or error-related status | Error, Blocked |
| Info | Informational or descriptive status | Info, Details |
| Warning | Cautionary or pending status | Pending, Needs Review |
Badge container
When displaying multiple badges together, wrap them in a badge-container.
- Ensures consistent alignment and spacing.
- Prevents wrapping and spacing issues across layouts.
- Required when more than one badge appears inline.
Badges
Badges in elements
Badges can act as decorators within other elements.
Icon tiles
.icon-tile is a squared-off counterpart to the pill-shaped .badge — a small rounded container for a logo, icon, or single-letter initial fallback (e.g. a carrier mark in a card heading). Add >img or >svg for a logo, or drop plain text for an initial. Sits on the base gray at rest; on a .filled-* surface it inverts to a white tile.
Size modifiers: .icon-tile-sm (24×24) and .icon-tile-lg (40×40).