---
title: Configure Purple Variants
slug: editorial/configure-purple-variants
description: This guide provides instructions on how to configure article (post) variants in Purple Hub via the Purple Variants feature. Variants enable you to create separate versions of content for various platforms, such as online or print. 
docTags: 
createdAt: 2024-09-24T13:46:37.394Z
---

Purple Hub

***

## Summary

This guide provides instructions on how to configure article (post) variants in Purple Hub via the Purple Variants feature. Variants enable you to create separate versions of content for various platforms, such as online or print. This configuration ensures each format can be handled independently within the Purple Hub. 

***

## Preconditions

- Have the "Purple Variants" Plugin enabled in Purple Hub. This can only be done by a Super Admin, a role restricted to Purple staff. If you want us to enable the Plugin for you [open a ticket in our Support Helpdesk](https://sprylab.freshdesk.com/en/support/tickets/new).
- Have an Admin role in Purple Hub to configure Purple Variants

***

## Purple Variants Settings

::Image[]{src="https://api.archbee.com/api/optimize/sCxKkm0StdQInfax4mSE5-DaDBinxTaSTN0Q0p3nBXW-20240924-155347.png" size="40" width="558" height="976" position="center" caption="Purple Hub left hand side menu" alt="Purple Hub left hand side menu" darkWidth="558" darkHeight="976" showCaption="true"}

Once the Purple Variants plugin is activated, within the **Settings (1)** menu, you will now see a new sub-menu labeled **Purple Variants Settings (2)**. With click on this sub-menu opens the configuration page for Purple Variants.

### Default Variant

![](https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/OWF4c513NHOzVrhKiqVrM_image.png)

Upon installation, a **default variant** **(1) **is automatically created.

:::hint{type="info"}
Note: This default variant cannot be deleted. However, it can be removed from the interface by toggling the 'Hide' option on the right side of the row.
:::

### Creating a new variant

![Creating a variant](https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/qIgqP6tQ-FNyBcopf_Nyd_image.png "Creating a variant")

Creating a new variant:

- Enter the **name (1) **for the variant (e.g., Online).
- The **Identifier (2) **field is automatically generated based on the variant name and cannot be changed.
- Selection of the **variant icon (3)**:
- **Save (4)** to add the variant to the list or click **Cancel (5) **to revert your changes.

### Managing variants

![](https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/miWGoVM8jh1KZzhUHBBYi_image.png)

After saving, the new variant will appear in the list of configured variants.

You can:

- By clicking **Edit (1) **the variant’s **name (2)** and **icon (3) **can be changed.
- The **Identifier (4) **remains fixed, even if you edit the variant's name.
- Delete the variant by clicking the **Delete (5)** button.

### Variant icons

::Image[]{src="https://api.archbee.com/api/optimize/sCxKkm0StdQInfax4mSE5-AkDfxOy9hgRKB4IJ-c1Xk-20241104-192403.png" size="30" width="256" height="162" position="center" caption="Variants icons" alt="Variants icons" darkWidth="256" darkHeight="162" showCaption="true"}

Each variant is assigned a unique icon to help visually differentiate between them. Icons are automatically displayed next to each variant type (Neutral, Online, Print) in Purple Hub for you to quickly identify them.

### Visibility in the editor interface

By default, the Purple Variants editor sidebar is only visible for article types managed by the Purple Variants plugin. The interface can be displayed for all article types by toggling the switch above the table:

::Image[]{src="https://api.archbee.com/api/optimize/ygR6KtT9QI_R0u3uKTJsm/n1fdVbtnKorXJWju7iGvA_image.png" size="62" width="933" height="93" position="center" caption="Variant display toggle" alt="Variant display toggle" darkWidth="933" darkHeight="93" showCaption="true"}

### API Identifier (optional)

If you are integrating with external APIs, note that Purple Hub automatically assigns a unique **API Identifier** to each variant. This identifier allows external systems to retrieve content for specific variants.

The content type identifier provided to external services will be the variant's identifier prefixed by "pv\_"