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