Skip to content

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-container to 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 ​

VariantDescriptionExample Use
DefaultNeutral badge for general labelingLabels, metadata
PrimaryBrand-emphasized badgeFeatured, highlighted states
SuccessPositive or completed statusActive, Approved
DangerCritical or error-related statusError, Blocked
InfoInformational or descriptive statusInfo, Details
WarningCautionary or pending statusPending, 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).