Tag

Tags are compact, non-interactive labels used to categorize, filter, or display metadata. They communicate status, type, or category at a glance and can include icons for added context.

Anatomy

A tag consists of a container with optional leading icon and required label text.

Container — Rounded pill with variant-specific background.

Leading icon — Optional small icon for visual context.

Label — Short descriptive text content.

Label only Container + Label
With icon Icon + Label

Variants

Tags come in five semantic variants to support different use cases.

Primary — Default tag style with branded background.

Secondary — Outlined tag for less prominent categorization.

Static — Subtle emphasis-only fill, no border. Non-interactive style.

Active — Inverted high-contrast for selected/active state.

Info — Informational color for status or alert context.

Primary Secondary Static Active Info

States

Tags support default and disabled states. Hover states apply to interactive tags.

Default — Resting state with full contrast.

Hover — Slightly stronger background on pointer over.

Disabled — Muted fill with reduced text contrast.

Default Hover Disabled
Primary
Label
Label
Label
Secondary
Label
Label
Label
Active
Label
Label
Label

Sizes

Tags are available in two sizes.

Large (lg) — Default size, body-sm font.

Small (sm) — Compact, caption font for dense UIs.

Large tag lg
Small tag sm

Primary

Tag
Code snippet
Package name <Tag> Storybook source
tsx
<Tag
  onClick={function f0e(){}}
  size="lg"
  variant="primary"
>
  Tag
</Tag>

With Icons

Tags can include a leading icon to reinforce meaning or add visual weight.

Icons should be small and contextual — avoid icons that compete with the label text.

Add genre Pop New
Code snippet
Package name <Tag> Storybook source
tsx
<Tag
  onClick={function f0e(){}}
  size="lg"
  variant="primary"
>
  <Icon
    size="md"
    type="plus"
  />
  <span>
    Tag
  </span>
</Tag>

Guidelines

  • Keep tag labels short (1-3 words). Tags communicate categories, not descriptions.
  • Use a consistent variant within a group — don't mix Primary and Secondary in the same row unless indicating different states.
  • Use the Info variant for system-generated metadata or temporary status indicators.
  • Active variant should only be used when the tag represents a user-confirmed selection or toggle state.
  • Disabled tags should be avoided when possible — prefer hiding unavailable tags entirely.

Dos and Don'ts

Pop Rock R&B
Do

Use tags to categorize items with short, scannable labels.

This song belongs to pop genre Created on January 2024
Don't

Don't use long sentences or full descriptions inside tags.