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

Element

Description

Optional?

1. Tag container

Primary container that holds the label and optional Icon and Avatar.

No

2. Tag label

User-generated text describing the tag.

No

3. Avatar

Leading Avatar that helps differentiate an entity, such as a Space or a Tenant.

Yes

4. Icon

Leading icon that helps differentiate between what objects tags are associated with.

Yes

5. Dismiss button

Indicates the tag can be dismissed.

Yes


Variants

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

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

Type

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

  1. Text-only
  2. Icon and text
  3. Avatar and text
tag-type-text-icon-avatar

Dismissible Tags

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

The dismiss button has the following states:

  1. Rest
  2. Hover
  3. Focus
tag-dismissible

Component dependencies

This component is internally dependent on the following components:


Help and support