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. 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 token, 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 |
|
|