Manage Variant Groups

Note: The Entry Variants feature is currently available as part of an Early Access Program and may not be available to all users. For more information, you can reach out to our support team.

The Variants page in Contentstack allows you to view all the variant groups and the available variants within them.

Note:

Each experience created in your Personalize project appears as a Variant Group (with the same name as the Experience) in the linked stack.
When a stack is actively linked to a Personalize project, you cannot create, edit, or delete the title or description of variant groups or variants.

Accessing Variants

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

Navigate to the desired stack and click the Settings icon (or press “S”).
Select Variants in the navigation panel on the left.

This opens the Variants page.

Variants List Overview

The Variants page displays a list of all the Variant Groups coming from Personalize. Following is an overview of all the details available on this page:

Variant Group: The name of the variant group.
Linked With: Indicates the connection status of the variant group with Personalize.
Variant(s): Total number of variants available within the variant group.
Linked Content-Type(s): The content types linked with the variant group.
Modified At: The date and time along with the user name who modified the variant group.

Variant Group Details

When you click a particular variant group, you will be redirected to the Variant Group Details page where you can view the Variant Group Name, Description, Variants, and Linked Content Types within it.

Note: These fields are currently not editable as they originate from experiences created in Personalize.

When variants are unlinked from the variant group (due to changes in Personalize), they appear in the Unlinked Variants section, where you can:

Re-link variant: Reconnects the variant with the group. Once re-linked, you can create entry variants.
Remove variant: Removes the variant from the variant group and all associated entry variants are deleted and unpublished if they were previously published.

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

Linking Content Types

Here’s how you can link content types to your variants groups:

Within the Linked Content Types field, you can select one or more content types you want to link to the variant group.
Click Apply to link the variant group to the selected content types.
Finally, click Save to save your changes.

Unlinking Content Types

Unlinked content types move to a separate Unlinked Content Types section, where you can:

Re-link content type: Reconnects the content type and re-enables entry variant creation.
Remove content type: Removes the content type from the variant group and all associated entry variants are deleted and unpublished if they were previously published.

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

With this, your Variant Group is linked to the selected content type(s) and you will be able to see a “Variants” dropdown in the entry editor page that will allow you to create an entry variant. Refer to our documentation on Create an Entry Variant for more details.

Managing variant groups and entry variants in Contentstack allows you to deliver personalized content tailored to your users. The Variants page provides an efficient way to view and link variant groups to your content types, enhancing dynamic content delivery.

API Reference

To manage variant groups via API, refer to the Variant Groups collection.