🏷️ Tag — Documentation

🧭 When to Use / When Not to Use

Use When

• You need to display categorical metadata (status, type, label).
• You want to represent filters, attributes, or classifications.
• You need dismissible chips to represent selected filters.
• Items need color-coding (status, priority, user group).

Avoid When

• The content represents navigational actions → use Button or Link.
• Tags become interactive toggles → use Toggle Chip or Pill.
• You need to display large text blocks → use Badge or Label.
• You need highly detailed affordances → use Card or Chip.

🎨 Considerations

Size Usage

• Small:
  • Dense UIs
  • Compact lists or data tables
  • Subtle metadata
• Large:
  • Filters
  • Prominent categorization
  • More readable labels

Color Usage Guidance