---
title: "Create a theme"
slug: "create-a-theme "
abstract: "Create a theme to define reusable visual styles and adapt your designs for different brands, campaigns, or visual identities."
---

# Create a theme

> [!important]
> The features described in this topic are available only to customers enrolled in [Early Access](https://forms.cloud.microsoft/Pages/ResponsePage.aspx?id=hAFwkRTDyU27fqQR30VqHj_zY3lpy3dGhZKklnheMCxURUpHTkhSSzI4QkhCUFMzSDM2M1ZGRkYwMi4u) and are intended for testing in non-production environments.

Themes let you create consistent visual styles for your sites and components without changing their structure. 

In Design Studio, you can create reusable themes using standardized design tokens for design decisions such as colors, typography, spacing, and effects. By changing token values in a theme, you can adapt the same components to different brands, campaigns, or visual identities while keeping your design system consistent.

A theme is based on a design schema and can use values from a token set prepared by your development team. The design schema connects Design Studio to your website styling by mapping semantic design tokens to the CSS variables used by the rendering host. It acts as the template from which compatible themes can be created.

A token represents a named design setting, such as a color or font. A token set groups tokens and their values so they can be reused as a starting point for themes.

For example, instead of independently choosing the primary color every time you style a component, your design system can define a token for the primary color. You can then give that token a different value in each theme. The components continue to use the same token, but their appearance changes with the selected theme. This lets organizations reuse components while adapting their appearance to different brands or campaigns. 

> [!Note]
> Before you can create a theme, you must configure the design schema and the tokens available for your implementation. 

To create a theme:
1.	In Design Studio, in the left toolbar, click **Themes**.
2.	In the **Custom themes** section, click **Create custom theme**.
3.	Enter a **Name** for the theme. This is a stable, system-facing value used to identify the theme, for example 'corporate-blue'.
4.	Enter a **Display name** for the theme. This is the human-friendly label you will see in Design Studio UI when you view or select a theme, for example, 'Corporate blue'.
5.	Select the **Site** or **Design schema** you want to use associate with the theme. This cannot be changed afterwards.
6.	Select the **Token set** you want to use as the starting point for the theme.
7.	Click **Create**.

The theme contains the tokens defined by its design schema. You can now review the theme or customize it before saving it to your foundation folder. When you’re happy with how your theme looks, you must publish it to make it available for use outside Design Studio.
