#Create Variants
Variants allow you to create multiple versions of a main content entry, such as different regional or personalized editions. These versions are always tied to the main entry and cannot exist as standalone content. You can use Variants to tailor specific text, images, or other field values for each audience or locale while keeping all versions organized under the main content entry.
#Create Variants
Your developer must enable Variants and add Segments in Hygraph before you can add personalized versions of the main content entry. Share this document with the developer to activate this feature in your project.
- Go to the Content Editor, and open your content entry. This is the main content entry.
- In the right sidebar, under Variants, select Add. A new version of the content entry is displayed. The values from the main entry for the default locale are copied into the Variant entry. This makes it easier to make adjustments, especially when the Variant only differs slightly from the main entry.
- To add a new locale to the Variant, in the right sidebar, under Localizations, click the
+
icon next to the locale. The empty localized fields appear and you can enter the localized text for the Variant in these fields.
- To add a new locale to the Variant, in the right sidebar, under Localizations, click the
- Only the fields that have Variant support enabled are available for editing. Make changes to the available fields, as required.
- Turn on the Show all fields toggle to view the rest of the fields in the content model in read-only mode. If you want to edit the read-only fields, you need to go back to the content entry.
- Now, click Select segment.
- Choose one or more Segments that this Variant applies, and click Add selected entries.
- Click Save or Save & publish.
You need to publish the Segment to the same stage as the Variants to see Variants of a certain Segment.
#Modify a Variant
After you save a Variant, you can modify the values in different fields of the Variant. You can also modify the Segments that you linked to this Variant.
- Link more Segments - Select the Segment that you added, and click Add segment.
- Unlink a Segment - Hover over the context menu next to a Segment, and click Remove.
#Behavior of Variant fields
Each variant maintains its own values independently. If the same content is needed across entries, you need to manually update it in each entry. When working with variant fields, note the following points:
- Main entry updates: Updating a variant-enabled field in the main entry does not update the same field in its variants.
- Variant Entry updates: Changes made to variant fields do not affect the corresponding fields in the main entry.
Publishing the main entry doesn’t auto-publish its variants. You need to publish each variant separately. To be able to publish a variant, you must have already published the main entry.