Link tokens
Token and description | Light value | Dark 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 description | Light value | Dark 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 description | Light value | Dark 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 description | Light value | Dark 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 description | Light value | Dark 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 description | Light value | Dark 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. |