Skip to content

Design Tokens Reference

The platform injects design tokens into your widget's Shadow DOM as CSS custom properties. Every token below is available on every community.

Reference a token with var() and always give it a fallback. The fallback applies whenever the property is not set — before a community's branding has loaded, or outside a community context altogether. Use the token's Default value as that fallback, except for the --font-family-* tokens: their defaults name a single family, so append a generic family after it (var(--font-family-sans, Roboto, sans-serif)).

Widget tokens

Theme

TokenDefault value
--theme-brand-100#F7F0FE
--theme-brand-200#E9D8FD
--theme-brand-300#CEAAF8
--theme-brand-400#BC8CF2
--theme-brand-500#AF7AEB
--theme-brand-600#A267E4
--theme-brand-700#9254D9
--theme-brand-800#7B3BC4
--theme-brand-900#452965
--theme-brand-1000#322541
--theme-neutral-0#FFFFFF
--theme-neutral-100#FAFAFA
--theme-neutral-200#F4F5F6
--theme-neutral-300#DEDFE2
--theme-neutral-400#B8BBC2
--theme-neutral-500#8D919B
--theme-neutral-600#7B808E
--theme-neutral-700#696E7C
--theme-neutral-800#4F5663
--theme-neutral-900#3B4254
--theme-neutral-1000#2B3346

Color

TokenDefault valueDescription
--color-action-destructive-default#c92c2fcolor used for actions that perform irreversible or potentially harmful operations
--color-action-destructive-hover#ae2424color used when a destructive action is hovered
--color-action-destructive-pressed#5d1a1ccolor used when a destructive action is actively pressed
--color-action-neutral-default#FFFFFFcolor used for less prominent actions that support the primary action
--color-action-neutral-hover#FAFAFAcolor used when a secondary action is hovered
--color-action-neutral-pressed#F4F5F6color used when a secondary action is actively pressed
--color-action-primary-default#9254D9default color used for the most prominent call-to-action in the interface
--color-action-primary-hover#7B3BC4color used when a primary action is hovered
--color-action-primary-pressed#452965color used when a primary action is actively pressed
--color-community-answered#1f8444color used to indicate that a question or thread has received an accepted answer
--color-community-highlighted#9254D9color used to highlight content that is featured or editorially promoted
--color-community-pinned#9254D9color used to indicate content that is pinned and prioritized in listings
--color-community-unanswered#696E7Ccolor used to indicate that a question or thread has not yet received a response
--color-content-default#2B3346default color used for primary body text and high-emphasis content
--color-content-disabled#B8BBC2color used for text on disabled elements or unavailable content
--color-content-heading-default#2B3346default color used for section and component headings
--color-content-heading-hero#FFFFFFcolor used for prominent page-level headings displayed on hero or banner areas
--color-content-inverse#FFFFFFcolor used for text displayed on high-contrast or brand-colored backgrounds
--color-content-subtle#4F5663color used for secondary text such as helper text, metadata, or supporting information
--color-content-subtlest#696E7Ccolor used for low-emphasis text such as placeholders or less important UI copy
--color-focus-ring#388bffdefault color used for focus rings on interactive elements
--color-line-default#DEDFE2default border and divider color used for standard UI boundaries, separators, and component outlines
--color-line-disabled#DEDFE2border and divider color used for disabled components or non-interactive states where visual emphasis is reduced
--color-link-default#9254D9default color used for interactive text links
--color-link-hover#7B3BC4color used for interactive text links on hover
--color-overlay-backdrop#2b33467asemi-transparent color displayed behind modals to obscure background content
--color-overlay-interactive-hover#2b33460aoverlay color applied to interactive elements to indicate a hover state
--color-overlay-interactive-pressed#2b334614overlay color applied to interactive elements to indicate an active or pressed state
--color-skeleton-default#F4F5F6base color used for loading placeholders while content is being fetched
--color-skeleton-subtle#2b33460ahighlight color used in animated skeleton states to simulate loading progress
--color-status-danger-bold#c92c2fhigh-emphasis color used for neutral informational messages
--color-status-information-bold#0c66e4high-emphasis color used to indicate errors or critical issues
--color-status-success-bold#1f8444high-emphasis color used to communicate successful outcomes or confirmations
--color-surface-default#FFFFFFdefault container surface for standard UI sections (cards, panels, content areas)
--color-surface-disabled#F4F5F6background of disabled interactive elements such as inputs, buttons, or selection controls
--color-surface-inverse#2B3346color used for inverse surfaces such as tooltips and high-contrast floating UI
--color-surface-muted#F4F5F6sub-surface used inside containers to visually group secondary areas (e.g., comment/reply bubbles)
--color-surface-overlay#FFFFFFelevated surface for overlays and floating layers (modals, dropdowns, popovers).
--color-surface-page#FAFAFAapplication canvas background used behind all UI surfaces

Text

TokenDefault value
--text-body-large-font-size1.25rem
--text-body-large-font-weight400
--text-body-large-line-height1.5
--text-body-medium-font-size1rem
--text-body-medium-font-weight400
--text-body-medium-line-height1.5
--text-body-small-font-size0.875rem
--text-body-small-font-weight400
--text-body-small-line-height1.5
--text-button-font-size0.875rem
--text-button-font-weight500
--text-button-line-height1.25rem
--text-caption-font-size0.75rem
--text-caption-font-weight400
--text-caption-line-height1rem
--text-code-font-size1rem
--text-code-font-weight400
--text-code-line-height1.5
--text-heading-large-font-size1.75rem
--text-heading-large-font-weight700
--text-heading-large-line-height1.25
--text-heading-medium-font-size1.5rem
--text-heading-medium-font-weight500
--text-heading-medium-line-height1.25
--text-heading-small-font-size1.25rem
--text-heading-small-font-weight500
--text-heading-small-line-height1.25
--text-heading-xlarge-font-size2rem
--text-heading-xlarge-font-weight700
--text-heading-xlarge-line-height1.25
--text-hero-font-size2rem
--text-hero-font-weight700
--text-hero-line-height1.25
--text-label-medium-font-size1rem
--text-label-medium-font-weight500
--text-label-medium-line-height1.5rem
--text-label-small-font-size0.875rem
--text-label-small-font-weight500
--text-label-small-line-height1.25rem
--text-menu-font-size0.875rem
--text-menu-font-weight400
--text-menu-line-height1.25rem
--text-navigation-font-size0.875rem
--text-navigation-font-weight400
--text-navigation-line-height1.25rem

Font

TokenDefault value
--font-family-buttonRoboto
--font-family-headingRoboto
--font-family-monoRoboto Mono
--font-family-sansRoboto
--font-size-1000.75rem
--font-size-2000.875rem
--font-size-3001rem
--font-size-4001.25rem
--font-size-5001.5rem
--font-size-6001.75rem
--font-size-7002rem
--font-size-base16px
--font-weight-bold700
--font-weight-medium500
--font-weight-regular400

Space

TokenDefault valueDescription
--space-00px
--space-0252px
--space-0504px
--space-0756px
--space-1008px
--space-12510px
--space-15012px
--space-20016px
--space-25020px
--space-30024px
--space-40032px
--space-50040px
--space-60048px
--space-80064px
--space-100080px
--space-layout-gutter10pxspace used as the default gap between columns or layout elements
--space-negative-025-2px
--space-negative-050-4px
--space-negative-075-6px
--space-negative-100-8px
--space-negative-150-12px
--space-negative-200-16px

Radius

TokenDefault value
--radius-0252px
--radius-0504px
--radius-1008px
--radius-15012px
--radius-20016px
--radius-full9999px

Border

TokenDefault value
--border-width-1001px
--border-width-2002px

Line

TokenDefault value
--line-height-grid-1001rem
--line-height-grid-2001.25rem
--line-height-grid-3001.5rem
--line-height-grid-4001.75rem
--line-height-grid-5002rem
--line-height-grid-6002.25rem
--line-height-grid-7002.5rem
--line-height-ratio-relaxed1.5
--line-height-ratio-tight1.25

Shadow

TokenDefault value
--shadow-1000px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)
--shadow-2000px 4px 6px -4px rgba(0, 0, 0, 0.1), 0px 10px 15px -3px rgba(0, 0, 0, 0.1)
--shadow-3000px 8px 10px -6px rgba(0, 0, 0, 0.1), 0px 20px 25px -5px rgba(0, 0, 0, 0.1)

Elevation

TokenDefault valueDescription
--elevation-10px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)low elevation used for raised surfaces above the base layout
--elevation-20px 4px 6px -4px rgba(0, 0, 0, 0.1), 0px 10px 15px -3px rgba(0, 0, 0, 0.1)medium elevation used for floating surfaces above regular content
--elevation-30px 8px 10px -6px rgba(0, 0, 0, 0.1), 0px 20px 25px -5px rgba(0, 0, 0, 0.1)high elevation used for top-level surfaces above other floating elements

Button

TokenDefault valueDescription
--button-border-width1pxBorder width used for all button variants.
--button-destructive-background-default#c92c2fDestructive button background in default state.
--button-destructive-background-hover#ae2424Destructive button background on hover.
--button-destructive-background-pressed#5d1a1cDestructive button background on press.
--button-destructive-border-default#00000000Destructive button border color in default state (no visible border).
--button-destructive-border-hover#00000000Destructive button border color on hover (no visible border).
--button-destructive-border-pressed#00000000Destructive button border color on press (no visible border).
--button-destructive-content-default#FFFFFFDestructive button label/icon color in default state.
--button-destructive-content-hover#FFFFFFDestructive button label/icon color on hover.
--button-destructive-content-pressed#FFFFFFDestructive button label/icon color on press.
--button-destructive-shadownoneDestructive button shadow (none).
--button-font-weight500Font weight used for button labels across all variants.
--button-primary-background-default#9254D9Primary button background in default state.
--button-primary-background-hover#7B3BC4Primary button background on hover.
--button-primary-background-pressed#452965Primary button background on press.
--button-primary-border-default#00000000Primary button border color in default state (no visible border).
--button-primary-border-hover#00000000Primary button border color on hover (no visible border).
--button-primary-border-pressed#00000000Primary button border color on press (no visible border).
--button-primary-content-default#FFFFFFPrimary button label/icon color in default state.
--button-primary-content-hover#FFFFFFPrimary button label/icon color on hover.
--button-primary-content-pressed#FFFFFFPrimary button label/icon color on press.
--button-primary-shadownonePrimary button shadow (none).
--button-radius8pxBorder radius used for all button variants.
--button-secondary-background-default#FFFFFFSecondary button background in default state.
--button-secondary-background-hover#FAFAFASecondary button background on hover.
--button-secondary-background-pressed#F4F5F6Secondary button background on press.
--button-secondary-border-default#DEDFE2Secondary button border color in default state.
--button-secondary-border-hover#DEDFE2Secondary button border color on hover.
--button-secondary-border-pressed#DEDFE2Secondary button border color on press.
--button-secondary-content-default#2B3346Secondary button label/icon color in default state.
--button-secondary-content-hover#2B3346Secondary button label/icon color on hover.
--button-secondary-content-pressed#2B3346Secondary button label/icon color on press.
--button-secondary-shadownoneSecondary button shadow (none).
--button-text-transformnoneText transform applied to button labels (e.g., none/uppercase).
--button-vote-background-default#FFFFFFVote button background in default state.
--button-vote-background-hover#FAFAFAVote button background on hover.
--button-vote-background-pressed#F4F5F6Vote button background on press.
--button-vote-border-default#DEDFE2Vote button border color in default state.
--button-vote-border-hover#DEDFE2Vote button border color on hover.
--button-vote-border-pressed#DEDFE2Vote button border color on press.
--button-vote-content-default#2B3346Vote button content color in default state.
--button-vote-content-hover#2B3346Vote button content color on hover.
--button-vote-content-pressed#2B3346Vote button content color on press.
--button-vote-selected-background-default#9254D9Vote button background when selected (default).
--button-vote-selected-background-hover#7B3BC4Vote button background when selected (hovered).
--button-vote-selected-background-pressed#452965Vote button background when selected (pressed).
--button-vote-selected-border-default#00000000Vote button border when selected (default) (no visible border).
--button-vote-selected-border-hover#00000000Vote button border when selected (hovered) (no visible border).
--button-vote-selected-border-pressed#00000000Vote button border when selected (pressed) (no visible border).
--button-vote-selected-content-default#FFFFFFVote button content color when selected (default).
--button-vote-selected-content-hover#FFFFFFVote button content color when selected (hovered).
--button-vote-selected-content-pressed#FFFFFFVote button content color when selected (pressed).
--button-vote-selected-shadow-defaultnoneVote button shadow when selected (default) (none).
--button-vote-selected-shadow-hovernoneVote button shadow when selected (hovered) (none).
--button-vote-selected-shadow-pressednoneVote button shadow when selected (pressed) (none).
--button-vote-shadow-defaultnoneVote button shadow in default state (none).
--button-vote-shadow-hovernoneVote button shadow on hover (none).
--button-vote-shadow-pressednoneVote button shadow on press (none).

Card

TokenDefault valueDescription
--card-background-default#FFFFFFCard background in default state.
--card-background-hover#FFFFFFCard background on hover.
--card-background-pressed#FFFFFFCard background on press.
--card-border-default#DEDFE2Card border color in default state.
--card-border-hover#DEDFE2Card border color on hover.
--card-border-pressed#DEDFE2Card border color on press.
--card-border-width1pxBorder width used for cards.
--card-content-default#2B3346Card body/content color in default state.
--card-content-hover#2B3346Card body/content color on hover.
--card-content-pressed#7B3BC4Card body/content color on press (link hovered styling).
--card-radius8pxBorder radius used for cards.
--card-shadow-defaultnoneCard shadow in default state (none).
--card-shadow-hover0px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)Card shadow on hover.
--card-shadow-pressed0px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)Card shadow on press.
--card-title-default#2B3346Card title color in default state.
--card-title-hover#9254D9Card title color on hover (link styling).
--card-title-pressed#2B3346Card title color on press.

Community page tokens

These style the community's own pages — its navigation, sidebars, and feeds. They are listed so you can recognize them, but a widget should not use them: they are not part of a widget's own styling.

Back to Top (not for widgets)

TokenDefault valueDescription
--backtotop-background#2B3346Back-to-top button background.
--backtotop-content#FFFFFFBack-to-top button icon/content color.

Feed (not for widgets)

TokenDefault valueDescription
--feed-container-background#FFFFFFFeed container background.
--feed-container-border-color#DEDFE2Feed container border color.
--feed-container-border-width1pxBorder width used for the feed container.
--feed-container-radius8pxBorder radius used for the feed container.
--feed-container-shadownoneFeed container shadow (none).
--feed-item-background-default#FFFFFFFeed item background in default state.
--feed-item-background-hover#FFFFFFFeed item background on hover.
--feed-item-background-pressed#FFFFFFFeed item background on press.
--feed-item-border-default#DEDFE2Feed item border color in default state.
--feed-item-border-hover#DEDFE2Feed item border color on hover.
--feed-item-border-pressed#DEDFE2Feed item border color on press.
--feed-item-border-width1pxBorder width used for feed items.
--feed-item-content-default#2B3346Feed item content color in default state.
--feed-item-content-hover#2B3346Feed item content color on hover.
--feed-item-content-pressed#7B3BC4Feed item content color on press (link hovered styling).
--feed-item-radius8pxBorder radius used for feed items.
--feed-item-shadow-defaultnoneFeed item shadow in default state (none).
--feed-item-shadow-hover0px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)Feed item shadow on hover.
--feed-item-shadow-pressed0px 2px 4px -2px rgba(0, 0, 0, 0.1), 0px 4px 6px -1px rgba(0, 0, 0, 0.1)Feed item shadow on press.
--feed-item-title-default#2B3346Feed item title color in default state.
--feed-item-title-hover#9254D9Feed item title color on hover (link styling).
--feed-item-title-pressed#7B3BC4Feed item title color on press (link hovered styling).
TokenDefault valueDescription
--navigation-background#FFFFFFNavigation bar background.
--navigation-border-bottom#DEDFE2Bottom border of navigation.
--navigation-border-top#00000000Top border of navigation (transparent).
--navigation-content#2B3346Navigation bar content color (text/icons).
--navigation-dropdown-background#FFFFFFNavigation dropdown background.
--navigation-dropdown-content#2B3346Navigation dropdown content color.
TokenDefault valueDescription
--sidebar-background#FFFFFFSidebar widget placeholder background color.
--sidebar-border-color#DEDFE2Sidebar widget placeholder border color.
--sidebar-border-radius8pxSidebar widget placeholder border radius.
--sidebar-border-width1pxSidebar widget placeholder border width.
--sidebar-shadownoneSidebar widget placeholder box shadow.
--sidebar-title-color#2B3346Sidebar widget title text color.
--sidebar-title-font-familyRobotoSidebar widget title font family.
--sidebar-title-font-weight500Sidebar widget title font weight.

Page Panels (not for widgets)

TokenDefault valueDescription
--widget-background#FAFAFADefault widget background.
--widget-featured-background#0c66e4Featured topic widget background.
--widget-featured-content#FFFFFFFeatured topic widget content color.
--widget-hero-backgrounduploaded imageBackground of the hero section.
--widget-hero-content-shadownoneHero widget content shadow (none; handled by image/overlay as needed).
--widget-hero-height240pxHeight of the hero section.
--widget-hero-subtitle#FFFFFFHero widget subtitle color.
--widget-hero-title#FFFFFFHero widget title color.
--widget-introduction-background#FFFFFFIntroduction widget background.
--widget-introduction-close-content#696E7CIntroduction widget close button color.
--widget-introduction-content#2B3346Introduction widget body/content color.
--widget-introduction-icon-background#1f8444Introduction widget icon container background.
--widget-introduction-icon-content#FFFFFFIntroduction widget icon color.
--widget-shadownoneDefault widget shadow (none).
--widget-subtitle#2B3346Default widget subtitle color.
--widget-title#2B3346Default widget title color.

Next Steps

Gainsight CC Developer Portal