Tag

Tags help users quickly recognize important information about items that organize and categorize them. They visually label items with small amounts of information or the item’s status, usually with keywords that help organize and categorize the items.

Also known as:

BadgePillChipLabelLozengeInput tag

Tags help categorize and organize.
Use sentiment labels only for sentiment or other employee feedback data.
Tags may be persistent or dismissible. Dismissible tags can be added or removed by users.

When to use

When not to use

Modes

Types

Use default tags to label items
Use sentiment tags only for sentiment or other employee feedback data
Use validation tags for indicating the validation state such as the Cautionary style for cautioning users that the item has a validation warning that could be addressed.
Use status tags to show the status of surveys, reports, action plans, and performance feedback.
When a user can remove tags, use dismissible tags.
When a user can add tags, use dismissible tags with a Secondary Action Button to “Add” tags.
The tag label is an adjective or noun, not a verb.
Sizes:
- Use small tags when they’re inline with other text
- Use medium tags in rows with a single item displayed next to the tag
Link tags let you provide a link to somewhere or to filter content by that tag.
- Link tags have hover and focus styles that default tags do not.
- When used as a filter tag, link tags instantly filter content on click.
Long labels or user-generated content:
- Tags ideally use very short labels (1 word only). If we need tags for user-generated content, however, that might lead to long labels. In that case, we have an opt in option for “truncate text” which kicks in when the container constrains the Tag to a size where the text no longer fits. If the full label is NOT visible elsewhere in the UI, then the Tag also needs a Tooltip on hover/focus to show the full label.

Here are some examples of existing design system tags: