Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#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

  1. Go to the Content Editor, and open your content entry. This is the main content entry.
  2. 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.
  3. 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.
  4. Now, click Select segment.
  5. Choose one or more Segments that this Variant applies, and click Add selected entries.
  6. Click Save or Save & publish.

#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.