---
title: "Create a design schema"
slug: "create-a-design-schema "
abstract: "Create a design schema to define design tokens for themes and connect Design Studio styles to your website."
---

# Create a design schema

> [!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.

A design schema defines which design tokens you can use to create themes and connects those tokens to the styling in your website. It maps semantic design tokens to CSS variables so that your rendering host knows how to render the styles you define in Design Studio. The design schema then acts as the template for the themes you create. 

For example, your design schema might define tokens for your primary and secondary colors, typography, spacing, and other design properties. You can then create multiple themes from the same schema and assign different values to those tokens for different brands or campaigns.

A SitecoreAI environment can contain multiple design schemas. Each rendering host can be associated with only one design schema, but you can associate the same design schema with multiple rendering hosts. This lets sites that use the same design system share the same theme structure while using different theme values: you can create multiple themes from that schema, allowing sites on the rendering host to use the same design structure with different visual styles.

To create a design schema manually:
1.	In Design Studio, open **Themes**.
2.	In the right-hand panel, in the **Design schemas** section, click **Add Design schema**.
3.	In the **Add Design schema** dialog, click **Add schema name** to enter a name for your schema.
4.	Optionally, click **Add description** to add a description of the new design schema.
5.	Click **Add group**, then give the new group a name, a description, and choose an icon. Click **Add group** when you are done.
6.	In the table at the bottom, enter a **Variable name**, select one of the available **Type**, then add a **Description** and a **Custom name** for the variable. When you are done filling all the fields, click away from the new variable, and a new variable line appear.
7.	To associate the design schema with one or more rendering hosts, click **Assign rendering host**.
8.	In the **Assign rendering hosts** dialog, choose the rendering host that can use this design schema. The dialog lists all the rendering hosts available, but since each rendering host can be associated with only one design schema, you can only select a rendering hosts that have not been assigned a schema yet. When you are done, click **Assign**.
9.	Click **Save**.

Your development team must ensure that the corresponding styling configuration is available in the code so that the rendering host and Design Studio interpret and apply the tokens consistently. 

To create a design schema from an existing JSON:
1.	In Design Studio, open **Themes**.
2.	In the right-hand panel, in the **Design schemas** section, click **Add Design schema**.
3.	In the **Add Design schema** dialog, click **Add schema name** to enter a name for your schema.
4.	Optionally, click **Add description** to add a description of the new design schema.
5.	You can paste a DTCG 2025.10 JSON document in the first field, or select a JSON file in the second field. Figma and Token Studio exports are not supported.
6.	Click **Validate and preview**.
    > [!Note]
    > Importing a JSON design schema replaces all existing groups and values previously entered in the schema. 
7.	To associate the design schema with one or more rendering hosts, click **Assign rendering host**.
8.	In the **Assign rendering hosts** dialog, choose the rendering hosts that can use this design schema. The dialog lists all the rendering hosts available, but since each rendering host can be associated with only one design schema, you can only select rendering hosts that have not been assigned a schema yet. When you are done, click **Assign**.
9.	Click **Save**.
