Tag

Used to categorize, classify or filter corresponding object, or to communicate user-generated labeling.

Stable
Show details
Stable
Published: October 07, 2025
Updated: October 13, 2025

Anatomy

Anatomy summary lists and describes all the elements within a component (including nested components).

tag-anatomy
  1. Tag container: Primary container that holds the label and optional Icon and Avatar.
  2. Tag label: User-generated text describing the tag.
  3. Avatar (optional): Leading Avatar that helps differentiate an entity, such as a Space or a Tenant.
  4. Icon (optional): Leading icon that helps differentiate between what objects tags are associated with.
  5. Dismiss Button (optional): Indicates the tag can be dismissed.

Variants

Variants contain different versions of the component depending on specific properties, such as state, size, color, optional iconography, etc.

Type

There are three types of Tags depending on which components are nested within:

tag-type-text-icon-avatar
Tag
Property Values Default
hasIcon Boolean true | false false
hasAvatar Boolean true | false false
✏️ label Text string Read-only tag
isDismissible Boolean true | false false

Dismissible Tags

Each type of Tag can be made dismissible, meaning that it can be dismissed by a user.

tag-dismissible

Component dependencies

This component is internally dependent on the following components:


Help and support