Tag

Tags represent a set of keywords that help label, categorize, and organize objects. Commonly used to signify the attributes of an object.

UsageCodeAccessibility
MathematicsHistoryScience
<sl-tag>Mathematics</sl-tag>
<sl-tag removable>History</sl-tag>
<sl-tag disabled removable>Science</sl-tag>

When to use

Categorization, Labeling, and Filtering

Use tags to categorize and label course content, enhancing organization, discoverability, and enabling efficient filtering of content on a page, within components, or through search functionalities. For instance, courses or lessons can be tagged with subjects such as "Mathematics," "Science," "History," or "Literature." This approach makes it easier for users to quickly find and access relevant materials.

User-Generated Tags

Enable users to create and manage their own custom labels, allowing for a personalized organization system. In a student dashboard, for example, users might tag their notes or assignments with custom labels like "Exam Prep," "Homework," "Group Project," or "To Review," facilitating better organization.

When not to use

Status Indicators

For tracking the status of tasks or items, such as "In Progress," "Completed," or "Pending," use a badge instead. Badges are specifically designed to convey status and can provide visual cues through colors, making them more effective for this purpose.

Anatomy tag

ItemNameDescriptionOptional
1ContainerThe container contains the label and close buttonno
2LabelThe label is a brief text that decribed the tagno
3Close buttonTo remove the tagyes

Anatomy tag list

ItemNameDescriptionOptional
1CounterDisplays the count of selected tags when not all tags are visible, with a maximum display of 99. If more than 99 tags are selected, it will be shown as "99+."yes
2List of tagsConsists of a collection of tagsno

Figma Options

With these options, you can tweak the appearance of the tag in Figma. They are available in the Design Panel so you can compose the tag to exactly fit the user experience need for the use case you are working on.

Tag

ItemOptionsDescription
Emphasissubtle boldIndicates the which emphasis the tag should have
State tagidle hover active disabledIndicates the state of the tag
State closeidle hover active disabledIndicates the state of the close button
Sizemd lgSize 'md' is the default size of the tag component
RemovablebooleanDisplays a close button
LabelvalueThe text of the label
Focus ringbooleanTo show the focus ring of the tag

Tag list

ItemOptionsDescription
Emphasissubtle boldIndicates the which emphasis the tag should have
Sizemd lgIndicates the size of the tag list
Items1 2 3 4 5 6Indicates how many tags are shown in the tag list
StackedbooleanIndicates if the tags are stacked, this will show a counter in front of the tag list
Interactive example