pattern-library checked

Carbon Design System Tag Component

Documents tag variants for labeling, categorization, dismissing, selecting, and operational disclosure, including placement, truncation, clickable areas, read-only non-interactive tags, and limits for heavily wrapped tag groups.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Chip selection Choose chip selection when the chip set itself is the user's answer to a short choice question. Selecting a chip changes only that chip group's answer and does not navigate, run an action, remove the option, or filter unrelated content. Carbon documents selectable tags, selected and unselected states, concise titles, grouping and wrapping limits, keyboard operation, and distinctions from read-only, dismissible, and operational tags.
Filter chips Choose filter chips when there are a few high-frequency filters that can stay visible near the result set without overwhelming scanning. Selecting a filter chip toggles only that filter and updates the result count or result list without changing unrelated query, sort, pagination, or view state. Carbon tag guidance documents selectable and dismissible tags for filtering, concise titles, keyboard operation, spacing, and avoiding multi-function tags.
Tag / status tag Choose tag when the label is compact, read-only, attached to a visible object, and useful for scanning or comparison. A read-only tag does not receive focus, show hover affordance, expose pressed or selected state, or claim click behavior. Carbon documents read-only, dismissible, selectable, and operational tag variants, clarifying when tag-like elements become controls.

Evidence Role

This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Carbon Design System. Last checked: .