Updating theme colors

Every theme has a unique set of colors that you can configure using theme settings to instantly align the look-and-feel of your Zendesk help center with your company brand.

On this page

When previewing your theme in Zendesk Guide you can use the following settings to instantly update colors throughout your theme:

Global colors

Colors in the Colors setting group are used throughout the theme.

NameIdentifierDescription
Primary colorcolor_primaryThe primary color used for major navigational elements and buttons
Primary text colorcolor_primary_inverseThe text color for elements where the primary color is used
Secondary colorcolor_secondaryThe secondary color which can be applied to elements
Secondary text colorcolor_secondary_inverseThe text color for elements where the secondary color is used
Tertiary colorcolor_tertiaryThe tertiary color which can be applied to elements
Tertiary text colorcolor_tertiary_inverseThe text color for elements where the tertiary color is used
Heading colorcolor_headingColor for heading elements
Text colorcolor_textColor for text elements
Link colorcolor_linkText color for link elements
Border colorcolor_borderBorder color used for general elements
Outline colorcolor_outlineOutline color for the focus state of form fields
Gray lightestcolor_gray_100The lightest shade of gray
Gray lightcolor_gray_200The second lightest shade of gray
Graycolor_gray_600The main shade of gray
Background colorbg_colorThe general page background color

Header colors

Colors in the Header elements setting group apply specifically to the page header.

NameIdentifierDescription
Header link colorcolor_header_linkColor for link elements in the standard page header
Header link color (fixed)color_header_link_fixedColor for link elements in the page header when it’s displayed above a hero element
Header background colorbg_color_headerBackground color for the page header

General colors

Colors in the General page elements setting group apply to various elements throughout the help center.

NameIdentifierDescription
Notification text colorcolor_notificationThe color for text within the notification configurable through theme settings
Notification background colorbg_color_notificationThe background color for the notification configurable through theme settings
Boxed background colorbg_color_boxedBackground color visible when a boxed layout is used

Home page colors

Colors in the Home page elements setting group apply to various elements on the Home page. Custom blocks, content blocks, contact blocks and call-to-action elements have their own dedicated setting groups.

NameIdentifierDescription
Hero heading colorcolor_hero_headingColor for headings in the hero element
Hero text colorcolor_hero_textColor for text in the hero element
Hero background color (1)bg_color_heroPrimary background color for the hero element
Hero background color (2)bg_color_secondary_heroSecondary background color for the hero element
Hero gradientbg_gradient_heroThe type of background color gradient to use

Custom block colors

Colors in the Custom blocks setting group apply to the optional and configurable set of custom blocks that can be displayed on the Home page. Custom blocks present arbitrary actions that you define through theme settings in a variety of different styles.

NameIdentifierDescription
Custom blocks colorcolor_custom_blocksColor palette used for custom blocks
Custom blocks background colorbg_color_custom_blocksBackground color for the custom blocks section

The color palette options available for custom blocks, content blocks and contact blocks reference built-in colors (“White”) and global colors defined in your theme settings (“Gray lightest”, “Gray light”, “Primary”, “Secondary” and “Tertiary”). How those colors are used depends on the style selected, which determines which template or micro-template is used.

Content block colors

Colors in the Content blocks setting group apply to the optional and configurable set of content blocks that can be displayed on the Home page. Content blocks can present categories, sections and/or articles in a variety of different styles.

NameIdentifierDescription
Content blocks colorcolor_content_blocksColor palette used for content blocks
Content blocks background colorbg_color_content_blocksBackground color for the content blocks section

Contact block colors

Colors in the Contact blocks setting group apply to the optional and configurable set of contact blocks that can be displayed on the Home page. Contact blocks can present contact options that you define through theme settings in a variety of different styles.

NameIdentifierDescription
Contact blocks colorcolor_contact_blocksColor palette used for contact blocks

Call-to-action colors

Colors in the Request CTA elements setting group apply to the optional and configurable call-to-action section that can be displayed throughout the help center. The call-to-action section presents the ability to submit a request to visitors and can be presented in a number of different styles.

NameIdentifierDescription
CTA heading colorcolor_heading_ctaColor for headings within the CTA
CTA text colorcolor_text_ctaColor for text elements within the CTA
CTA background colorbg_color_ctaBackground color for the CTA

Article page colors

Colors in the Article page elements setting group apply to elements on the Article page.

NameIdentifierDescription
Note colorcolor_noteColor for note content elements
Warning colorcolor_warningColor for warning content elements

Colors in the Footer elements setting group apply specifically to the page footer.

NameIdentifierDescription
Footer link colorcolor_footer_linkColor for link elements in the page footer
Footer background colorbg_color_footerBackground color for the page footer

Some themes will include additional color settings depending on their style requirements.

Adding and changing colors

Sass variables

You can add your own custom color palettes using Sass by defining them in your theme’s _variables.scss file. If you specify a value for one that already exists in the framework _variables.scss file it will be overridden.

All colors defined in the $colors Sass variable are used to generate text, background and border color utilities. By default, this includes all colors except for the Heading, Text, Link and Outline theme colors.

The following example adds a purple color palette to the theme:

$colors: (
  "purple-100": #faf5ff,
  "purple-300": #d6bcfa,
  "purple-500": #9f7aea,
  "purple-700": #6b46c1,
  "purple-900": #44337a,
);

Using .text-purple-500 on an element would then change the text color of that element to that shade of purple.

Theme settings

You can add new custom theme settings to the theme’s Settings panel by updating the manifest.json file.

Although updating colors using Sass variables or directly in the style.css file is often easier, this approach allows others to change the color in the future directly using theme settings and without the need to touch any code.

Questions or feedback about this article? Let us know