Skip to main contentCarbon Design System

Tag

Color

Tag uses component level tokens and values from the IBM Design Language color palette. In the light themes tags use color step 20 for the background and step 70 for the text. In the dark themes, tags use color step 70 for the background and step 20 for the text. For the list of token values, see Carbon repo.

Tag colorColor token
Default$tag-background-gray
$tag-color-gray
$tag-hover-gray
Red$tag-background-red
$tag-color-red
$tag-hover-red
Magenta$tag-background-magenta
$tag-color-magenta
$tag-hover-magenta
Purple$tag-background-purple
$tag-color-purple
$tag-hover-purple
Blue$tag-background-blue
$tag-color-blue
$tag-hover-blue
Cyan$tag-background-cyan
$tag-color-cyan
$tag-hover-cyan
Teal$tag-background-teal
$tag-color-teal
$tag-hover-teal
Green$tag-background-green
$tag-color-green
$tag-hover-green
Gray$tag-background-gray
$tag-color-gray
$tag-hover-gray
Cool gray$tag-background-cool-gray
$tag-color-cool-gray
$tag-hover-cool-gray
Warm gray$tag-background-warm-gray
$tag-color-warm-gray
$tag-hover-warm-gray
High contrast$background-inverse
$text-inverse

Typography

Tag labels should be set in sentence case, and should only have one word. However, if more than one is necessary, then connect the words using a hyphen with no spaces.

ElementFont-size (px/rem)Font-weightType token
Label12 / 0.75Regular / 400$label-01

Structure

All tags have the same height. However, the width of tags varies based on the amount of content. All four corners of a tag are rounded with a 24px radius.

ElementPropertypx / remSpacing token
Tag (md)height24 / 1.5
radius12px
margin8 / 0.5$spacing-03
padding-left, padding-right8 / 0.5$spacing-03
Tag (sm)height18 / 1.125
radius9px
margin8 / 0.5$spacing-03
padding-left, padding-right8 / 0.5$spacing-03
Structure and spacing measurements

Structure and spacing measurements for a tag | px / rem

Sizes

SizeHeight px / rem
Small18px / 1.125
Medium24 / 1.5
Sizes for tag

Tag sizes | px / rem