Skip to content

How to create a theme

Creating a custom theme allows you to define specific colors, typography, and layout settings that can be reused across all your surveys. This ensures brand consistency and provides an easy way to customize the user interface.

TIP

If you want to learn more about the science behind our color engine and the semantic roles of each color (Primary, Secondary, Surface, etc.), please read our Explanation of the Color System.

Step 1: Edit Theme Settings

Navigate to your customer organization settings and select the option to manage themes.

Open theme settings
Select the theme settings option from the navigation menu.

Click on the button to add or edit a theme.

Edit theme settings
Navigate to the theme editor to begin customizing.

Step 2: Choose a Seed Color

The easiest way to start is by selecting a base "seed color" for your brand. This primary color will be used to automatically generate a harmonious color palette for your theme.

Select a seed color
Select your primary brand color to generate a palette.

You can use the color picker to select the exact hue you need. The system will automatically ensure that the generated colors meet WCAG AA contrast requirements.

Color picker
Use the color picker for precise color selection.

Step 3: Customize Theme Colors

Once your initial palette is generated, you can fine-tune specific color assignments to match your exact brand requirements.

Customize theme colors
Review and adjust the generated theme colors.

You can adjust properties like hue and chroma (color intensity) using the provided sliders.

Adjust hue slider
Fine-tune the color hue.
Adjust chroma slider
Adjust the color intensity (chroma).

You can also explicitly define surface colors and background contrasts. Expanding the surface colors section gives you full control over the background elements of your surveys.

Surface colors settings
Configure surface colors.
Expanded surface colors
Expand for detailed surface color control.

Step 4: Review Contrast Settings

Accessibility is a key part of custom themes. The editor provides built-in contrast checking to ensure your text (onSurface) remains legible against your background (surface) colors.

Contrast settings and warnings
Review contrast settings to ensure accessibility compliance.

WARNING

The editor will display warnings if your chosen color combinations fall below the minimum 3:1 contrast ratio required for WCAG AA compliance.

Step 5: Save and Activate

After reviewing your color applications and ensuring your theme looks correct across different elements, save your changes.

Apply color changes
Apply your finalized color selections.
Activate theme
Set the theme as active.

Finally, click the Save button to store your new theme. It will now be available to select when creating or editing surveys.

Save the new theme
Save your theme so it can be applied to surveys.