Configure variants

Developers must define variant options and values for each product. These definitions create the foundation for product variants. A variant option is a specific type of variation like a color or size that the product comes in. For each variant option, the Developer must provide at least one possible value.

Add options and values

This section describes how to add options and values.

To add a variant options and values to a product:

1. If you are not already on the product dashboard page, click Manage > Billing and Distribution > Products > productName | Edit.
   The Product Dashboard page for the selected product opens.
2. Click Variants.
   The Variants page opens.
3. Click Add Variant Options.
   The Variant Options are open.
4. Enter the following information:
   1. Name - Define the name for the variant option, such as Color or Storage.
   2. Type - Select text or color. Selecting a color allows for the selection from a color picker and the assignment of a specific name (for example, labeling a selected color as "Graphite"). For text, provide a label for the option, allowing for free text entry by the end customer based on these labels.
   3. Values - Input possible values for the defined option, like red and blue for colors, or 64GB and 128GB for storage capacities. Add multiple values by clicking Add Value for every subsequent possible value within an option.
5. (Optional) Click Add Optionsand Add Value to add new options and values.
6. After adding the options and values, click Generate Variants to compile a list of product variants, each assigned an auto-generated name based on the option’s values and SKU, which developers can customize.

Update options and values

Options and values for variants are flexible and can be adjusted as product offerings evolve.

To update options and values:

1. If you are not already on the product dashboard page, click Manage > Billing and Distribution > Products > productName | Edit.
   The Product Dashboard page for the selected product opens.
2. Click Variants.
   The Variants page opens.
3. Click Edit Options to modify as follows:
   • Add new options and corresponding values.
   • Insert additional values for existing options.
   • Remove options along with all associated values.
   • Delete specific values for an option.
   • Edit details of options and values.
4. Click Generate Variants to regenerate or update the product's variant list based on the new configurations.

Delete options and values

To remove an entire option along with all its associated values, click on the Trash icon next to the option you wish to delete.

To remove a specific value within an option, click on the Trash icon next to the respective value.

After making changes to your options and values, ensure you click Generate Variants to regenerate or update your variants list with these changes.

📝 Note As with non-variants products, you will have to publish a product for changes to take effect in your production catalog, see Publish products.

Understand variant regeneration

Variant regeneration occurs each time an option or value is added, removed, or modified, and the developer triggers variant generation to create or update the existing variants, ensuring your product variants reflect the most current configurations. Here's what to expect:

• Initial generation: The first time variants are generated, they receive default names based on their options and values. They will also share common pricing and physical attributes defined in those sections.
• Modifications: Adding or removing options or values triggers regeneration. This updates variant details to default settings, including names, pricing models, and physical attributes, based on the new combinations.

Regeneration is key for keeping product listings accurate as your offerings evolve. After regeneration, review and adjust variant details as needed to ensure they meet your specific requirements.

Edit individual variants

After the initial variant generation, which assigns a common pricing model and physical attributes to all variants, you might find the need to customize individual variants. This customization could include adjustments to names, SKUs, pricing, and physical attributes to accurately reflect differences across variants.

To edit individual variants:

1. If you are not already on the product dashboard page, click Manage > Billing and Distribution > Products > productName | Edit.
   The Product Dashboard page for the selected product opens.
2. Click Variants.
   The Variants page opens listing all generated variants.
3. Select the variant you want to modify and click Edit in the corresponding row.
4. Click Edit on the desired section you want to modify.
   1. Attributes
      1. Modify the name of the variant to better suit its unique characteristics or to make it more identifiable.
      2. Adjust the SKU (Stock Keeping Unit), which serves as the unique identifier for the variant in your system and is crucial for backend integrations and fulfillment requests.
   2. Pricing
      Access and modify the pricing options for the variant. This allows you to set different prices across variants depending on their unique features or customer value. For detailed information on available pricing options, refer to Create pricing template.
   3. Physical Attributes
      Update the physical attributes of the variant, such as dimensions and weight, to reflect any differences from the common set initially applied to all variants. For more details on what can be modified, refer to Configure physical attributes.
5. Save your changes.
   1. Save All: To apply your changes across all sections (Attributes, Pricing, Physical Attributes), click Save All. This ensures all modifications are saved simultaneously.
   2. Individual Save: If you prefer to save changes one section at a time, click Save on each component. This option is useful when you need to make incremental updates or confirm changes before proceeding to the next section.