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 | 
  | 
  |