---
title: Create content variations
slug: cms-saas/docs/create-content-variation
docTags: 
createdAt: 2026-07-30T20:18:08.000Z
---

Content variations let you create multiple versions of a page or content item. Each variation is identified by a unique string in its variation field. These variations are useful for optimizing content performance and enhancing user engagement. The following are some examples of how content variations can be used:

- **Run an A/B test** – Compare different versions of a page or content element to see which performs better based on engagement, conversions, or other key metrics. Let Mark (Optimizely Agent Platform) choose the winning variant automatically.
- **Deliver personalized content** – Show variations based on user segments, demographics, or behaviors to create a more relevant experience.
- **Localize content** – Display different versions for different languages or cultural preferences to better reach a global audience.
- **Support seasonal campaigns** – Tailor content for specific promotions or time-based events without changing the original structure.
- **Improve content performance** – Test variations of headlines, images, or calls-to-action to boost SEO and increase interaction.
- **React quickly to feedback** – Make content changes based on market trends or user behavior without disrupting the original content.

:::hint{type="info"}
**Note**
If you are using Optimizely Graph to [retrieve content](https://docs.developers.optimizely.com/platform-optimizely/docs/retrieve-content-variations), you can filter and query content variations directly in your GraphQL queries. GraphQL queries must, by default, only return items that do not have any value in the `variation` field.
:::

## Add a content variation

1. Select a page from the content tree.

:::hint{type="info"}
**Note**
You cannot create a variation from **Root**.
:::

2. Click **Variations > Add variation**. The **Add variation** window displays.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Qr2iPw-YJZxZaVtWoNwv6_a1d9112d8699b6964af58dd596a193d80b5a3fb331cd59555ae50ecc973e5e5f-image.png)

3. Enter a name for the content variation. The name cannot start with a number or include spaces. The following example uses *WinterCampaign*.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BaTN1Offxhij6Gs8CD5-__d23c3be403b075117887f1a9398a4dfd27375cf5a77433f2830f08cd7b93107b-image.png)

4. Click **Add variation**. The variation (*WinterCampaign*) displays in the **Variations** drop-down list.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/01hj_fkPndRDUzgOjHujF_2d3d0f8b7e4d7fe7f77fcc607777fcd2e0ab41ec7811b0b290cb34f3fe5a80fd-image.png)

## Edit a content variation

1. Select **Variations > WinterCampaign**. The variation of the original displays.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/dM_A6DwDiExrOfs318P61_bf7325ad64b7b954aa6702ccbdff750c7de292e9fba1eeaacb49fcf537d938d4-image.png)

Because the variation is a version of the page, you can see it in the **Version** gadget with an icon.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/NrkeZNOVJGUH41crqyQqi_7c94d3a359b7aef3142c2bfceed8b9bce292e803a91b0c030ecc857d609b0091-image.png)

2. Make changes to the variation of the original. You can toggle between the original and the variation as you make changes.
3. Publish the variation. If you subsequently update the variation again, another version displays in the list of versions because each variation has the same publication cycle as the language version.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ducrIFCpHvt4oXBi_Gu3S_3a8cd6267f6d334202574ed507a1135496ccc149f75a856558319238a2e439b0-image.png)

## Add a variation from a variation

1. Select **Variations > Add variation**.
2. On the **Add variation** window, enter a name for the content variation. Do not start with a number or add spaces. The following example uses *SummerCampaign*:

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/DOqpchDz5vBLx08onibpa_ed34e0868e4b731e454f5c29aa164d48f0af7c76a470ea4a05333b4dd3e07a67-image.png)

3. Select a variation from the **Copy from** field. In this case, select **WinterCampaign**.
4. Click **Add variation**. The **SummerCampaign** variation starts out as a copy of the **WinterCampaign** variation and displays in the **Variations** drop-down list.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ebnhhKkatpKtrN3rG3knJ_6408958bdd04cd71025ce156fa632a96961db478522c135d82c1511a8e81cb52-image.png)

## Promote a variation to the original content

If you make changes to a variation that you want to become the baseline for further variations, you can promote a variation to overwrite the original.

1. Go to the variation you want to become the original.
2. Go to the **Publish** (**Options**) drop-down list and select **Copy changes to Original**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0rvzRLOZnujsb90fRaN3X_71ca2214e7e502cd37b0ec98e2367cbbee52baa79f99453d22e8c499877a6b23-image.png)