# CMS: Creating Page Variants for Dynamic Pages

Source: https://support.wix.com/en/article/cms-creating-page-variants-for-dynamic-pages (updated 2026-11-10)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Page variants let you display different layouts for different subsets of items on the same dynamic item page in Wix Studio. Instead of showing every item with the same design, you can create variant layouts that serve specific groups of items based on filters you define. For example, if you have a portfolio collection, you could create one layout for 'Marketing' projects and a different layout for 'Design' projects, while keeping all items under the same dynamic page URL structure.

  
 Page variants are available only for dynamic item pages that use a dynamic variable in the URL. All variants share the original page's dataset, URL pattern, permissions, and SEO settings. This means sort order, base filters, and page access are managed on the original dynamic page, not separately for each variant.

> **Before your begin:**
>
> * Page variants are currently available in [Wix Studio](https://support.wix.com/en/article/about-wix-studio) only.
> * You can only create variants for [dynamic item pages](https://support.wix.com/en/article/cms-about-dynamic-pages#dynamic-item-pages) that use a dynamic variable in the URL. [Dynamic list pages](https://support.wix.com/en/article/cms-about-dynamic-pages#dynamic-list-pages) do not support variants.

---

## Adding a page variant

You can add a page variant to any dynamic item page. When creating a variant, choose whether to start with a copy of the original page's design or build from a blank canvas.

### To add a page variant:

1. [Go to your editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Click **Pages** on the left side of the editor.
3. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant dynamic item page.
4. Click **Add page variant**.
5. Enter the **Variant name**.
6. Select how you want to start:  
   * **Duplicate original design:** Create a copy of the original page's layout.  
   * **Start from scratch:** Create a blank page connected to the same dataset.

![Screenshot of creating a dynamic page variant.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/dc1e5a83-9cc9-4d20-a21c-2adea536c362/6a06f8a8-348b-4f82-8ba3-8960ab7f9bd8.png)

1. Click **Continue**.
2. Set up the page variant rules:  
   1. Click the **Field** dropdown and select the field you want to filter by.  
   2. Click the **Condition** dropdown and select a condition.  
   3. (If needed) Enter or select the value for your filter condition.  
   4. (Optional) Click **+ Add new rule** to add more filter conditions. Items must match all rules to display on this variant.
3. Click **Add variant**.

![Screenshot of setting the variant page rules.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/3f3243cb-fa5e-48f5-b27c-22171e28a03b/04417276-51f2-49b2-876e-72ad9238adc2.png)

---

## Editing variant rules

After creating a page variant, you can edit the rules that define which collection items display on that variant. The rules modal lets you set filter conditions using fields from your collection. Items must match all rules (AND logic) to display on the variant. Items that don't match any variant's rules display on the original page layout.

> **Important:** **Filter hierarchy:** The original page's base filter determines which items are available across all variants. Variant rules then narrow down from that base set. If the original page later filters out an item already matching a variant's rules, that item disappears from the variant as well.

### To edit variant rules:

1. Click **Pages** on the left side of the editor.
2. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant page variant.
3. Click **Edit variant rules**.
4. Edit the page variant rules:  
   1. Click the **Field** dropdown and select the field you want to filter by.  
   2. Click the **Condition** dropdown and select a condition.  
   3. (If needed) Enter or select the value for your filter condition.  
   4. (Optional) Click **+ Add new rule** to add more filter conditions. Items must match all rules to display on this variant.
5. Click **Save**.

---

## Understanding how items route to variants

When a visitor navigates to a dynamic page URL, the system determines which layout to display based on the following logic:

* **Variant filters evaluated first:** The system checks each variant's filter against the item.
* **Conflict resolution:** If an item matches multiple variants, the variant that was created first takes priority.
* **Fallback to original:** If the item does not match any variant filter, the original page layout is used.
* **Previewing items:** When viewing a page variant in the editor, the dynamic page selector displays only the items assigned to that specific variant.

---

## Managing variant dataset settings

All page variants share the same dataset as the original dynamic page. This means certain dataset settings are global and managed only on the original page. 

* **Sort order:** There is a single shared sort configuration defined on the original page. On variant pages, the sort setting is read-only.
* **Base filters:** The original page's filters define which items are eligible across all page variants. On variant pages, the base filter section is read-only.
* **Variant-specific items:** On variant pages, the dataset includes an "Items in this variant" section that reflects the filters you defined in the Assign Items modal. To edit these, use the **Assign items** action from the variant's context menu.

---

## Duplicating a page variant

You can duplicate any existing page variant to create a new one with the same layout. After duplicating, you can configure which items display on the new variant.

> **Note:** **Original page duplication:** When you duplicate the original dynamic page (not a variant), the variants are not included. Only the original layout is duplicated as a new dynamic page.

### To duplicate a page variant:

1. Click **Pages** on the left side of the editor.
2. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant page variant.
3. Click **Duplicate variant**.
4. Edit the **Variant name**.
5. Select how you want to start:  
   * **Duplicate original design:** Create a copy of the original page's layout.  
   * **Start from scratch:** Create a blank page connected to the same dataset.
6. Click **Continue**.
7. Set up the page variant rules:  
   1. Click the **Field** dropdown and select the field you want to filter by.  
   2. Click the **Condition** dropdown and select a condition.  
   3. (If needed) Enter or select the value for your filter condition.  
   4. (Optional) Click **+ Add new rule** to add more filter conditions. Items must match all rules to display on this variant.
8. Click **Add variant**.

---

## Deleting a page variant

You can delete individual page variants or the entire original dynamic page. Deleting the original page also removes all its associated variants.

> **Important:** **Deleting the original page:** If you delete a dynamic page that has variants, a confirmation modal appears explaining that all associated variant pages will also be permanently removed.

### To delete a page variant:

1. Click **Pages** on the left side of the editor.
2. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant page variant.
3. Click **Delete**.
4. Click **Delete Page** to confirm.

### To delete the original dynamic page and all its variants:

1. Click **Pages** on the left side of the editor.
2. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant original dynamic page.
3. Click **Delete**.
4. Review the confirmation modal explaining that all variant pages will also be permanently removed.
5. Click **Delete Page and Variants** to confirm.

---

## FAQs

Click below to learn more about creating dynamic page variants.

**How do I rename a page variant?**

To rename a page variant:

1. Click **Pages** on the left side of the editor.
2. Click the **More Actions** icon ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/04/16/e3f8736a-cdf0-4441-97d4-41a63efecb39/81e24fc8-741f-4f8c-a74a-7ef090eb9d5f.png) next to the relevant page variant.
3. Click **Rename**.
4. Enter the new name.
5. Press **Enter** on your keyboard.

**Are page variants available in all editors?**

Page variants are currently available in Wix Studio only. They are not supported in the Wix Editor or other editors at this time.

**Can I add page variants to a dynamic list page?**

No. Page variants are only available on dynamic item pages that have a dynamic variable in the URL. Dynamic list pages do not support variants.

**Can I remove the dynamic variable from a page's URL while it has variants?**

No. You cannot remove the dynamic variable from a page's URL pattern while it has page variants. To change the URL structure, remove all variants first.

**Can I set separate SEO settings for each variant?**

No. All variants inherit the SEO configuration from the original dynamic page. SEO settings can only be managed on the original page. Learn more about [working with SEO settings for dynamic pages](https://support.wix.com/en/article/working-with-seo-settings-for-dynamic-pages).

**Do page variants have their own permissions?**

No. All items currently inherit the same permissions regardless of which variant layout they display on. Permissions are managed at the dynamic page level, not per variant.

**What field types aren’t supported for creating dynamic page variant rules?**

At the moment, it is not possible to use reference, multi-reference, or tags fields to create dynamic page variant rules.
