Color tokens

new

Color tokens use for the text, background, icon, border and link of elements.

Token and descriptionLight valueDark value
--ds-link
--ds-link-pressed

Use for links in a default or hovered state. Add an underline for hovered states.

--ds-link-visited

Use for links in a visited state.

Text tokens

Token and descriptionLight valueDark value
--ds-text

Use for primary text, such as body copy, sentence case headers, and buttons.

--ds-text-accent-lime

Use for lime text on subtlest and subtler lime accent backgrounds when there is no meaning tied to the

--ds-text-accent-lime-bolder

Use for lime text on subtle lime accent backgrounds when there is no meaning tied to the

--ds-text-accent-red

Use for red text on subtlest and subtler red accent backgrounds when there is no meaning tied to the

--ds-text-accent-red-bolder

Use for red text on subtle red accent backgrounds when there is no meaning tied to the

--ds-text-accent-orange

Use for orange text on subtlest and subtler orange accent backgrounds when there is no meaning tied to the

--ds-text-accent-orange-bolder

Use for orange text on subtle orange accent backgrounds when there is no meaning tied to the

--ds-text-accent-yellow

Use for yellow text on subtlest and subtler yellow accent backgrounds when there is no meaning tied to the

--ds-text-accent-yellow-bolder

Use for yellow text on subtle yellow accent backgrounds when there is no meaning tied to the

--ds-text-accent-green

Use for green text on subtlest and subtler green accent backgrounds when there is no meaning tied to the

--ds-text-accent-green-bolder

Use for green text on subtle green accent backgrounds when there is no meaning tied to the

--ds-text-accent-teal

Use for teal text on subtlest and subtler teal accent backgrounds when there is no meaning tied to the

--ds-text-accent-teal-bolder

Use for teal text on subtle teal accent backgrounds when there is no meaning tied to the

--ds-text-accent-blue

Use for blue text on subtlest and subtler blue accent backgrounds when there is no meaning tied to the

--ds-text-accent-blue-bolder

Use for blue text on subtle blue accent backgrounds when there is no meaning tied to the

--ds-text-accent-purple

Use for purple text on subtlest and subtler purple accent backgrounds when there is no meaning tied to the

--ds-text-accent-purple-bolder

Use for purple text on subtle purple accent backgrounds when there is no meaning tied to the

--ds-text-accent-magenta

Use for magenta text on subtlest and subtler magenta accent backgrounds when there is no meaning tied to the

--ds-text-accent-magenta-bolder

Use for magenta text on subtle magenta accent backgrounds when there is no meaning tied to the

--ds-text-accent-gray

Use for text on non-bold gray accent backgrounds, such as colored tags.

--ds-text-accent-gray-bolder

Use for text and icons on gray subtle accent backgrounds.

--ds-text-disabled

Use for text in a disabled state.

--ds-text-inverse

Use for text on bold backgrounds.

--ds-text-selected

Use for text in selected or opened states, such as tabs and dropdown buttons.

--ds-text-brand

Use for text that reinforces our brand.

--ds-text-danger

Use for critical text, such as input field error messaging.

--ds-text-warning

Use for text to emphasize caution, such as in moved lozenges.

--ds-text-warning-inverse

Use for text when on bold warning backgrounds.

--ds-text-success

Use for text to communicate a favorable outcome, such as input field success messaging.

--ds-text-discovery

Use for text to emphasize change or something new, such as in new lozenges.

--ds-text-information

Use for informative text or to communicate something is in progress, such as in-progress lozenges.

--ds-text-subtlest

Use for tertiary text, such as meta-data, breadcrumbs, input field placeholder and helper text.

--ds-text-subtle

Use for secondary text, such as navigation, subtle button links, input field labels, and all caps subheadings.

Background tokens

Token and descriptionLight valueDark value
--ds-background-accent-lime-subtlest
--ds-background-accent-lime-subtlest-hovered
--ds-background-accent-lime-subtlest-pressed

Use for for backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-lime-subtler
--ds-background-accent-lime-subtler-hovered
--ds-background-accent-lime-subtler-pressed

Use for for backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-lime-subtle
--ds-background-accent-lime-subtle-hovered
--ds-background-accent-lime-subtle-pressed

Use for vibrant for backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-lime-bolder
--ds-background-accent-lime-bolder-hovered
--ds-background-accent-lime-bolder-pressed

Use for for backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-red-subtlest
--ds-background-accent-red-subtlest-hovered
--ds-background-accent-red-subtlest-pressed

Use for red backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-red-subtler
--ds-background-accent-red-subtler-hovered
--ds-background-accent-red-subtler-pressed

Use for red backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-red-subtle
--ds-background-accent-red-subtle-hovered
--ds-background-accent-red-subtle-pressed

Use for vibrant red backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-red-bolder
--ds-background-accent-red-bolder-hovered
--ds-background-accent-red-bolder-pressed

Use for red backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-orange-subtlest
--ds-background-accent-orange-subtlest-hovered
--ds-background-accent-orange-subtlest-pressed

Use for orange backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-orange-subtler
--ds-background-accent-orange-subtler-hovered
--ds-background-accent-orange-subtler-pressed

Use for orange backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-orange-subtle
--ds-background-accent-orange-subtle-hovered
--ds-background-accent-orange-subtle-pressed

Use for vibrant orange backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-orange-bolder
--ds-background-accent-orange-bolder-hovered
--ds-background-accent-orange-bolder-pressed

Use for orange backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-yellow-subtlest
--ds-background-accent-yellow-subtlest-hovered
--ds-background-accent-yellow-subtlest-pressed

--ds-background-accent-yellow-subtler
--ds-background-accent-yellow-subtler-hovered
--ds-background-accent-yellow-subtler-pressed

Use for yellow backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-yellow-subtle
--ds-background-accent-yellow-subtle-hovered
--ds-background-accent-yellow-subtle-pressed

Use for vibrant yellow backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-yellow-bolder
--ds-background-accent-yellow-bolder-hovered
--ds-background-accent-yellow-bolder-pressed

Use for yellow backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-green-subtlest
--ds-background-accent-green-subtlest-hovered
--ds-background-accent-green-subtlest-pressed

Use for green backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-green-subtler
--ds-background-accent-green-subtler-hovered
--ds-background-accent-green-subtler-pressed

Use for green backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-green-subtle
--ds-background-accent-green-subtle-hovered
--ds-background-accent-green-subtle-pressed

Use for vibrant green backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-green-bolder
--ds-background-accent-green-bolder-hovered
--ds-background-accent-green-bolder-pressed

Use for green backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-teal-subtlest
--ds-background-accent-teal-subtlest-hovered
--ds-background-accent-teal-subtlest-pressed

Use for teal backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-teal-subtler
--ds-background-accent-teal-subtler-hovered
--ds-background-accent-teal-subtler-pressed

Use for teal backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-teal-subtle
--ds-background-accent-teal-subtle-hovered
--ds-background-accent-teal-subtle-pressed

Use for vibrant teal backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-teal-bolder
--ds-background-accent-teal-bolder-hovered
--ds-background-accent-teal-bolder-pressed

Use for teal backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-blue-subtlest
--ds-background-accent-blue-subtlest-hovered
--ds-background-accent-blue-subtlest-pressed

Use for blue backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-blue-subtler
--ds-background-accent-blue-subtler-hovered
--ds-background-accent-blue-subtler-pressed

Use for blue backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-blue-subtle
--ds-background-accent-blue-subtle-hovered
--ds-background-accent-blue-subtle-pressed

Use for vibrant blue backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-blue-bolder
--ds-background-accent-blue-bolder-hovered
--ds-background-accent-blue-bolder-pressed

Use for blue backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-purple-subtlest
--ds-background-accent-purple-subtlest-hovered
--ds-background-accent-purple-subtlest-pressed

Use for purple backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-purple-subtler
--ds-background-accent-purple-subtler-hovered
--ds-background-accent-purple-subtler-pressed

Use for purple backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-purple-subtle
--ds-background-accent-purple-subtle-hovered
--ds-background-accent-purple-subtle-pressed

Use for vibrant purple backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-purple-bolder
--ds-background-accent-purple-bolder-hovered
--ds-background-accent-purple-bolder-pressed

Use for purple backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-magenta-subtlest
--ds-background-accent-magenta-subtlest-hovered
--ds-background-accent-magenta-subtlest-pressed

Use for magenta backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-magenta-subtler
--ds-background-accent-magenta-subtler-hovered
--ds-background-accent-magenta-subtler-pressed

Use for magenta backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-magenta-subtle
--ds-background-accent-magenta-subtle-hovered
--ds-background-accent-magenta-subtle-pressed

Use for vibrant magenta backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-magenta-bolder
--ds-background-accent-magenta-bolder-hovered
--ds-background-accent-magenta-bolder-pressed

Use for magenta backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-accent-gray-subtlest
--ds-background-accent-gray-subtlest-hovered
--ds-background-accent-gray-subtlest-pressed

Use for gray backgrounds when there is no meaning tied to the Reserved for when you only want a hint of

--ds-background-accent-gray-subtler
--ds-background-accent-gray-subtler-hovered
--ds-background-accent-gray-subtler-pressed

Use for gray backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-gray-subtle
--ds-background-accent-gray-subtle-hovered
--ds-background-accent-gray-subtle-pressed

Use for vibrant gray backgrounds when there is no meaning tied to the color, such as colored tags.

--ds-background-accent-gray-bolder
--ds-background-accent-gray-bolder-hovered
--ds-background-accent-gray-bolder-pressed

Use for gray backgrounds when there is no meaning tied to the color, and the background needs to pass min 3:1 contrast requirements.

--ds-background-disabled

Use for backgrounds of elements in a disabled state.

--ds-background-input
--ds-background-input-hovered
--ds-background-input-pressed

Use for background of form UI elements, such as text fields, checkboxes, and radio buttons.

--ds-background-inverse-subtle
--ds-background-inverse-subtle-hovered
--ds-background-inverse-subtle-pressed

Use for backgrounds of elements on a bold background, such as in the buttons on spotlight cards.

--ds-background-neutral
--ds-background-neutral-hovered
--ds-background-neutral-pressed

The default background for neutral elements, such as default buttons.

--ds-background-neutral-subtle
--ds-background-neutral-subtle-hovered
--ds-background-neutral-subtle-pressed

Use for the background of elements that appear to have no background in a resting state, such as subtle buttons and menu items.

--ds-background-neutral-bold
--ds-background-neutral-bold-hovered
--ds-background-neutral-bold-pressed

A vibrant background option for neutral UI elements, such as announcement banners.

--ds-background-selected
--ds-background-selected-hovered
--ds-background-selected-pressed

Use for the background of elements in a selected state, such as in opened dropdown buttons.

--ds-background-selected-bold
--ds-background-selected-bold-hovered
--ds-background-selected-bold-pressed

Use for the backgrounds of elements in a selected state, such as checkboxes and radio buttons.

--ds-background-brand-subtlest
--ds-background-brand-subtlest-hovered
--ds-background-brand-subtlest-pressed

Use for the background of elements used to reinforce our brand, but with less emphasis.

--ds-background-brand-bold
--ds-background-brand-bold-hovered
--ds-background-brand-bold-pressed

Use for the background of elements used to reinforce our brand, but with more emphasis.

--ds-background-brand-boldest
--ds-background-brand-boldest-hovered
--ds-background-brand-boldest-pressed

Use for the background of elements used to reinforce our brand, that need to stand out a lot.

--ds-background-danger
--ds-background-danger-hovered
--ds-background-danger-pressed

Use for backgrounds communicating critical information, such in error section messages.

--ds-background-danger-bold
--ds-background-danger-bold-hovered
--ds-background-danger-bold-pressed

A vibrant background option for communicating critical information, such as in danger buttons and error banners.

--ds-background-warning
--ds-background-warning-hovered
--ds-background-warning-pressed

Use for backgrounds communicating caution, such as in warning section messages.

--ds-background-warning-bold
--ds-background-warning-bold-hovered
--ds-background-warning-bold-pressed

A vibrant background option for communicating caution, such as in warning buttons and warning banners.

--ds-background-success
--ds-background-success-hovered
--ds-background-success-pressed

Use for backgrounds communicating a favorable outcome, such as in success section messages.

--ds-background-success-bold
--ds-background-success-bold-hovered
--ds-background-success-bold-pressed

A vibrant background option for communicating a favorable outcome, such as in checked toggles.

--ds-background-discovery
--ds-background-discovery-hovered
--ds-background-discovery-pressed

Use for backgrounds communicating change or something new, such as in discovery section messages.

--ds-background-discovery-bold
--ds-background-discovery-bold-hovered
--ds-background-discovery-bold-pressed

A vibrant background option communicating change or something new, such as in onboarding spotlights.

--ds-background-information
--ds-background-information-hovered
--ds-background-information-pressed

Use for backgrounds communicating information or something in-progress, such as in information section messages.

--ds-background-information-bold
--ds-background-information-bold-hovered
--ds-background-information-bold-pressed

A vibrant background option for communicating information or something in-progress.

Surface tokens

Token and descriptionLight valueDark value
--ds-surface
--ds-surface-hovered
--ds-surface-pressed

Use as the primary background for the UI.

--ds-surface-overlay
--ds-surface-overlay-hovered
--ds-surface-overlay-pressed

Use for the background of elements that sit on top of they UI, such as modals, dialogs, dropdown menus, floating toolbars, and floating single-action buttons. Also use for the background of raised cards in a dragged state. Combine with shadow.overlay.

--ds-surface-raised
--ds-surface-raised-hovered
--ds-surface-raised-pressed

Use for the background of cards that can be moved, such as Jira cards on a Kanban board. Combine with shadow.raised.

--ds-surface-sunken

A secondary background for the UI commonly used for grouping items, such as Jira cards in columns.

Icon tokens

Token and descriptionLight valueDark value
--ds-icon

Use for icon-only buttons, or icons paired with text

--ds-icon-accent-lime

Use for lime icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-red

Use for red icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-orange

Use for orange icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-yellow

Use for yellow icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-green

Use for green icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-teal

Use for teal icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-blue

Use for blue icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-purple

Use for purple icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-magenta

Use for magenta icons on non-bold backgrounds when there is no meaning tied to the color, such as file type icons.

--ds-icon-accent-gray

Use for icons on non-bold gray accent backgrounds, such as file type icons.

--ds-icon-disabled

Use for icons in a disabled state.

--ds-icon-inverse

Use for icons on bold backgrounds.

--ds-icon-selected

Use for icons in selected or opened states, such as those used in dropdown buttons.

--ds-icon-brand

Use for icons that reinforce our brand.

--ds-icon-danger

Use for icons communicating critical information, such as those used in error handing.

--ds-icon-warning

Use for icons communicating caution, such as those used in warning section messages.

--ds-icon-warning-inverse

Use for icons when on bold warning backgrounds.

--ds-icon-success

Use for icons communicating a favorable outcome, such as those used in success section messaged.

--ds-icon-discovery

Use for icons communicating change or something new, such as discovery section messages.

--ds-icon-information

Use for icons communicating information or something in-progress, such as information section messages.

--ds-icon-subtle

Use for icons paired with text.subtle

Border tokens

Token and descriptionLight valueDark value
--ds-border

Use to visually group or separate UI elements, such as flat cards or side panel dividers.

--ds-border-accent-lime

Use for lime borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-red

Use for red borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-orange

Use for orange borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-yellow

Use for yellow borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-green

Use for green borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-teal

Use for teal borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-blue

Use for blue borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-purple

Use for purple borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-magenta

Use for magenta borders on non-bold backgrounds when there is no meaning tied to the

--ds-border-accent-gray

Use for borders on non-bold gray accent backgrounds.

--ds-border-disabled

Use for borders of elements in a disabled state.

--ds-border-focused

Use for focus rings of elements in a focus state.

--ds-border-input

Use for borders of form UI elements, such as text fields, checkboxes, and radio buttons.

--ds-border-inverse

Use for borders on bold backgrounds.

--ds-border-selected

Use for borders or visual indicators of elements in a selected or opened state, such as in tabs or menu items.

--ds-border-brand

Use for borders or visual indicators of elements that reinforce our brand, such as logos or primary buttons.

--ds-border-danger

Use for borders communicating critical information, such as the borders on invalid text fields.

--ds-border-warning

Use for borders communicating caution.

--ds-border-success

Use for borders communicating a favorable outcome, such as the borders on validated text fields.

--ds-border-discovery

Use for borders communicating change or something new, such as the borders in onboarding spotlights.

--ds-border-information

Use for borders communicating information or something in-progress.

--ds-border-bold

A neutral border option that passes min 3:1 contrast ratios.