Color
Tokens are a method of applying color in a consistent, reusable, and scalable way. They are used in place of hard coded values, like hex codes.
Core Tokens
Core tokens are global colors that are used across components. They are named and grouped by the common UI element that they are applied to.
| Token | Role | Value | 
|---|---|---|
| $background | 
 | 
 | 
| $background-hover | 
 | 
 | 
| $background-active | 
 | 
 | 
| $background-selected | 
 | 
 | 
| $background-selected-hover | 
 | 
 | 
| $background-inverse | 
 | 
 | 
| $background-inverse-hover | 
 | 
 | 
| $background-brand | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-01 | 
 | 
 | 
| $layer-02 | 
 | 
 | 
| $layer-03 | 
 | 
 | 
| $layer-hover-01 | 
 | 
 | 
| $layer-hover-02 | 
 | 
 | 
| $layer-hover-03 | 
 | 
 | 
| $layer-active-01 | 
 | 
 | 
| $layer-active-02 | 
 | 
 | 
| $layer-active-03 | 
 | 
 | 
| $layer-selected-01 | 
 | 
 | 
| $layer-selected-02 | 
 | 
 | 
| $layer-selected-03 | 
 | 
 | 
| $layer-selected-hover-01 | 
 | 
 | 
| $layer-selected-hover-02 | 
 | 
 | 
| $layer-selected-hover-03 | 
 | 
 | 
| $layer-selected-inverse | 
 | 
 | 
| $layer-selected-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-accent-01 | 
 | 
 | 
| $layer-accent-02 | 
 | 
 | 
| $layer-accent-03 | 
 | 
 | 
| $layer-accent-hover-01 | 
 | 
 | 
| $layer-accent-hover-02 | 
 | 
 | 
| $layer-accent-hover-03 | 
 | 
 | 
| $layer-accent-active-01 | 
 | 
 | 
| $layer-accent-active-02 | 
 | 
 | 
| $layer-accent-active-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $field-01 | 
 | 
 | 
| $field-02 | 
 | 
 | 
| $field-03 | 
 | 
 | 
| $field-hover-01 | 
 | 
 | 
| $field-hover-02 | 
 | 
 | 
| $field-hover-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $border-interactive | 
 | 
 | 
| $border-subtle-00 | 
 | 
 | 
| $border-subtle-01 | 
 | 
 | 
| $border-subtle-02 | 
 | 
 | 
| $border-subtle-03 | 
 | 
 | 
| $border-subtle-selected-01 | 
 | 
 | 
| $border-subtle-selected-02 | 
 | 
 | 
| $border-subtle-selected-03 | 
 | 
 | 
| $border-strong-01 | 
 | 
 | 
| $border-strong-02 | 
 | 
 | 
| $border-strong-03 | 
 | 
 | 
| $border-tile-01 | 
 | 
 | 
| $border-tile-02 | 
 | 
 | 
| $border-tile-03 | 
 | 
 | 
| $border-inverse | 
 | 
 | 
| $border-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $text-primary | 
 | 
 | 
| $text-secondary | 
 | 
 | 
| $text-placeholder | 
 | 
 | 
| $text-on-color | 
 | 
 | 
| $text-on-color-disabled | 
 | 
 | 
| $text-helper | 
 | 
 | 
| $text-error | 
 | 
 | 
| $text-inverse | 
 | 
 | 
| $text-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $link-primary | 
 | 
 | 
| $link-primary-hover | 
 | 
 | 
| $link-secondary | 
 | 
 | 
| $link-inverse | 
 | 
 | 
| $link-inverse-hover | 
 | 
 | 
| $link-inverse-active | 
 | 
 | 
| $link-inverse-visited | 
 | 
 | 
| $link-visited | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $icon-primary | 
 | 
 | 
| $icon-secondary | 
 | 
 | 
| $icon-on-color | 
 | 
 | 
| $icon-on-color-disabled | 
 | 
 | 
| $icon-interactive | 
 | 
 | 
| $icon-inverse | 
 | 
 | 
| $icon-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $support-error | 
 | 
 | 
| $support-success | 
 | 
 | 
| $support-warning | 
 | 
 | 
| $support-info | 
 | 
 | 
| $support-error-inverse | 
 | 
 | 
| $support-success-inverse | 
 | 
 | 
| $support-warning-inverse | 
 | 
 | 
| $support-info-inverse | 
 | 
 | 
| $support-caution-minor | 
 | 
 | 
| $support-caution-major | 
 | 
 | 
| $support-caution-undefined | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $focus | 
 | 
 | 
| $focus-inset | 
 | 
 | 
| $focus-inverse | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $interactive | 
 | 
 | 
| $highlight | 
 | 
 | 
| $toggle-off | 
 | 
 | 
| $overlay | 
 | 
 | 
| $skeleton-element | 
 | 
 | 
| $skeleton-background | 
 | 
 | 
Component Tokens
Some components have their own specific color tokens, known as component tokens. They represent the properties associated with a particular component. They are not global tokens like the core tokens and should never be used for anything other than their own component. For more information on how to use component tokens, see the developer documentation.
| Token | Role | Value | 
|---|---|---|
| $background | 
 | 
 | 
| $background-hover | 
 | 
 | 
| $background-active | 
 | 
 | 
| $background-selected | 
 | 
 | 
| $background-selected-hover | 
 | 
 | 
| $background-inverse | 
 | 
 | 
| $background-inverse-hover | 
 | 
 | 
| $background-brand | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-01 | 
 | 
 | 
| $layer-02 | 
 | 
 | 
| $layer-03 | 
 | 
 | 
| $layer-hover-01 | 
 | 
 | 
| $layer-hover-02 | 
 | 
 | 
| $layer-hover-03 | 
 | 
 | 
| $layer-active-01 | 
 | 
 | 
| $layer-active-02 | 
 | 
 | 
| $layer-active-03 | 
 | 
 | 
| $layer-selected-01 | 
 | 
 | 
| $layer-selected-02 | 
 | 
 | 
| $layer-selected-03 | 
 | 
 | 
| $layer-selected-hover-01 | 
 | 
 | 
| $layer-selected-hover-02 | 
 | 
 | 
| $layer-selected-hover-03 | 
 | 
 | 
| $layer-selected-inverse | 
 | 
 | 
| $layer-selected-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-accent-01 | 
 | 
 | 
| $layer-accent-02 | 
 | 
 | 
| $layer-accent-03 | 
 | 
 | 
| $layer-accent-hover-01 | 
 | 
 | 
| $layer-accent-hover-02 | 
 | 
 | 
| $layer-accent-hover-03 | 
 | 
 | 
| $layer-accent-active-01 | 
 | 
 | 
| $layer-accent-active-02 | 
 | 
 | 
| $layer-accent-active-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $field-01 | 
 | 
 | 
| $field-02 | 
 | 
 | 
| $field-03 | 
 | 
 | 
| $field-hover-01 | 
 | 
 | 
| $field-hover-02 | 
 | 
 | 
| $field-hover-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $border-interactive | 
 | 
 | 
| $border-subtle-00 | 
 | 
 | 
| $border-subtle-01 | 
 | 
 | 
| $border-subtle-02 | 
 | 
 | 
| $border-subtle-03 | 
 | 
 | 
| $border-subtle-selected-01 | 
 | 
 | 
| $border-subtle-selected-02 | 
 | 
 | 
| $border-subtle-selected-03 | 
 | 
 | 
| $border-strong-01 | 
 | 
 | 
| $border-strong-02 | 
 | 
 | 
| $border-strong-03 | 
 | 
 | 
| $border-tile-01 | 
 | 
 | 
| $border-tile-02 | 
 | 
 | 
| $border-tile-03 | 
 | 
 | 
| $border-inverse | 
 | 
 | 
| $border-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $text-primary | 
 | 
 | 
| $text-secondary | 
 | 
 | 
| $text-placeholder | 
 | 
 | 
| $text-on-color | 
 | 
 | 
| $text-on-color-disabled | 
 | 
 | 
| $text-helper | 
 | 
 | 
| $text-error | 
 | 
 | 
| $text-inverse | 
 | 
 | 
| $text-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $link-primary | 
 | 
 | 
| $link-primary-hover | 
 | 
 | 
| $link-secondary | 
 | 
 | 
| $link-inverse | 
 | 
 | 
| $link-inverse-hover | 
 | 
 | 
| $link-inverse-active | 
 | 
 | 
| $link-inverse-visited | 
 | 
 | 
| $link-visited | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $icon-primary | 
 | 
 | 
| $icon-secondary | 
 | 
 | 
| $icon-on-color | 
 | 
 | 
| $icon-on-color-disabled | 
 | 
 | 
| $icon-interactive | 
 | 
 | 
| $icon-inverse | 
 | 
 | 
| $icon-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $support-error | 
 | 
 | 
| $support-success | 
 | 
 | 
| $support-warning | 
 | 
 | 
| $support-info | 
 | 
 | 
| $support-error-inverse | 
 | 
 | 
| $support-success-inverse | 
 | 
 | 
| $support-warning-inverse | 
 | 
 | 
| $support-info-inverse | 
 | 
 | 
| $support-caution-minor | 
 | 
 | 
| $support-caution-major | 
 | 
 | 
| $support-caution-undefined | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $focus | 
 | 
 | 
| $focus-inset | 
 | 
 | 
| $focus-inverse | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $interactive | 
 | 
 | 
| $highlight | 
 | 
 | 
| $toggle-off | 
 | 
 | 
| $overlay | 
 | 
 | 
| $skeleton-element | 
 | 
 | 
| $skeleton-background | 
 | 
 | 
AI Tokens
To accommodate for the new AI styles, we have introduced a new suite of color tokens that can be found within the main Carbon themes. These tokens should only be used when building custom AI components, variants, or instances in your UI. For more information on how to use the AI tokens, see the Carbon for AI documentation.
| Token | Role | Value | 
|---|---|---|
| $background | 
 | 
 | 
| $background-hover | 
 | 
 | 
| $background-active | 
 | 
 | 
| $background-selected | 
 | 
 | 
| $background-selected-hover | 
 | 
 | 
| $background-inverse | 
 | 
 | 
| $background-inverse-hover | 
 | 
 | 
| $background-brand | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-01 | 
 | 
 | 
| $layer-02 | 
 | 
 | 
| $layer-03 | 
 | 
 | 
| $layer-hover-01 | 
 | 
 | 
| $layer-hover-02 | 
 | 
 | 
| $layer-hover-03 | 
 | 
 | 
| $layer-active-01 | 
 | 
 | 
| $layer-active-02 | 
 | 
 | 
| $layer-active-03 | 
 | 
 | 
| $layer-selected-01 | 
 | 
 | 
| $layer-selected-02 | 
 | 
 | 
| $layer-selected-03 | 
 | 
 | 
| $layer-selected-hover-01 | 
 | 
 | 
| $layer-selected-hover-02 | 
 | 
 | 
| $layer-selected-hover-03 | 
 | 
 | 
| $layer-selected-inverse | 
 | 
 | 
| $layer-selected-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $layer-accent-01 | 
 | 
 | 
| $layer-accent-02 | 
 | 
 | 
| $layer-accent-03 | 
 | 
 | 
| $layer-accent-hover-01 | 
 | 
 | 
| $layer-accent-hover-02 | 
 | 
 | 
| $layer-accent-hover-03 | 
 | 
 | 
| $layer-accent-active-01 | 
 | 
 | 
| $layer-accent-active-02 | 
 | 
 | 
| $layer-accent-active-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $field-01 | 
 | 
 | 
| $field-02 | 
 | 
 | 
| $field-03 | 
 | 
 | 
| $field-hover-01 | 
 | 
 | 
| $field-hover-02 | 
 | 
 | 
| $field-hover-03 | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $border-interactive | 
 | 
 | 
| $border-subtle-00 | 
 | 
 | 
| $border-subtle-01 | 
 | 
 | 
| $border-subtle-02 | 
 | 
 | 
| $border-subtle-03 | 
 | 
 | 
| $border-subtle-selected-01 | 
 | 
 | 
| $border-subtle-selected-02 | 
 | 
 | 
| $border-subtle-selected-03 | 
 | 
 | 
| $border-strong-01 | 
 | 
 | 
| $border-strong-02 | 
 | 
 | 
| $border-strong-03 | 
 | 
 | 
| $border-tile-01 | 
 | 
 | 
| $border-tile-02 | 
 | 
 | 
| $border-tile-03 | 
 | 
 | 
| $border-inverse | 
 | 
 | 
| $border-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $text-primary | 
 | 
 | 
| $text-secondary | 
 | 
 | 
| $text-placeholder | 
 | 
 | 
| $text-on-color | 
 | 
 | 
| $text-on-color-disabled | 
 | 
 | 
| $text-helper | 
 | 
 | 
| $text-error | 
 | 
 | 
| $text-inverse | 
 | 
 | 
| $text-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $link-primary | 
 | 
 | 
| $link-primary-hover | 
 | 
 | 
| $link-secondary | 
 | 
 | 
| $link-inverse | 
 | 
 | 
| $link-inverse-hover | 
 | 
 | 
| $link-inverse-active | 
 | 
 | 
| $link-inverse-visited | 
 | 
 | 
| $link-visited | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $icon-primary | 
 | 
 | 
| $icon-secondary | 
 | 
 | 
| $icon-on-color | 
 | 
 | 
| $icon-on-color-disabled | 
 | 
 | 
| $icon-interactive | 
 | 
 | 
| $icon-inverse | 
 | 
 | 
| $icon-disabled | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $support-error | 
 | 
 | 
| $support-success | 
 | 
 | 
| $support-warning | 
 | 
 | 
| $support-info | 
 | 
 | 
| $support-error-inverse | 
 | 
 | 
| $support-success-inverse | 
 | 
 | 
| $support-warning-inverse | 
 | 
 | 
| $support-info-inverse | 
 | 
 | 
| $support-caution-minor | 
 | 
 | 
| $support-caution-major | 
 | 
 | 
| $support-caution-undefined | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $focus | 
 | 
 | 
| $focus-inset | 
 | 
 | 
| $focus-inverse | 
 | 
 | 
| Token | Role | Value | 
|---|---|---|
| $interactive | 
 | 
 | 
| $highlight | 
 | 
 | 
| $toggle-off | 
 | 
 | 
| $overlay | 
 | 
 | 
| $skeleton-element | 
 | 
 | 
| $skeleton-background | 
 | 
 |