Manage Variant Groups

Note: The Entry Variants feature is available as part of the Personalize license and may not be accessible to all users. For more information, contact the support team.

The Variants page in Contentstack allows you to view all variant groups and the variants associated with them. Variant groups may originate from a linked Personalize project or be created independently within the CMS UI to support content modeling workflows.

Accessing Variant Groups

The Variant Groups page in the stack settings displays all available variant groups, including those linked to Personalize and those created independently in the CMS.

To access the variant groups, log in to your Contentstack account and perform the steps given below:

1. Navigate to the desired stack.
2. Click Settings.
3. Select Variants.

The Variants page opens and displays all available variant groups.

Variants List Overview

The Variants page displays all variant groups, including those linked to Personalize and those created independently in the CMS.

The following information is available for each variant group:

• Variant Group: The name of the variant group.
• Linked With: Indicates whether the group is linked to Personalize or unlinked meaning created within the stack.
• Variants: The variants available within the group.
• Linked Content Types: The content types associated with the variant group.
• Modified At: Displays the date, time, and user who last modified the group 

Create a Variant Group within the Stack

You can create independent variant groups directly in the CMS without requiring a Personalize integration.

To create a variant group, perform the following steps:

1. On the Variant Groups list page, click New Variant Group.
2. In the configuration modal, enter a Name for the variant group.
3. Under Linked Variants, specify the variants that you want to associate with this variant group.
4. Click Save to create a group.

Variant Group Details

Click a variant group to open the Variant Group Details page.

On this page, you can view the Name, Description, and the specific Variants within that group.

Note: For variant groups originating from Personalize, these fields are not editable. For groups created through the CMS UI, these fields remain editable.

If variants become unlinked from the group due to changes in Personalize, they appear in the Unlinked Variants section. From here, you can:

• Re-link Variant: Reconnect the variant to enable entry variant creation.
• Remove Variant: Delete the variant and all associated entry variants.

Link Content Types

To enable entry variants, you must link content types to a variant group.

Note: Content type assignments are branch-specific, meaning changes in one branch do not affect other branches.

To link content types, perform the following steps:

1. In the Linked Content Types field, select one or more content types.
2. Click Apply.
3. Click Save.

Unlinking Content Types

When content types are unlinked from a variant group, they appear in the Unlinked Content Types section.

From this section, you can perform the following actions:

• Re-link Content Type: Reconnect the content type and re-enable entry variant creation.
• Remove Content Type: Remove the content type and delete all associated entry variants.

Note: When a content type is unlinked, you can still update, publish, or unpublish existing entry variants. However, you cannot create new entry variants.

Using Variant Groups in Entries

After linking a variant group to a content type, a Variants dropdown appears in the entry editor. This allows you to create and manage entry variants for that content type.

For more information, refer to Create an Entry Variant.

API Reference

To manage variant groups via API, refer to the Variant Group API requests.