For the complete documentation index, see llms.txt. This page is also available as Markdown.

Product with variants

Introduction

A product with variants consists of a main product and simple products as its variants (similar to Magento configurable products).

If your product has multiple versions, such as colors, materials, or sizes, you will need a product with variants. To create one, follow the same initial steps as when creating a simple product, but when you see the Create product popup window, choose Product with variants from the Product type drop-down.

Fill in the other fields the same way; choosing categories is optional, and the Category list works like the Category quick filter, described in Quick filters. The differences will appear after you have created the product and moved to edit it. A Variants tab will become available, where you can select simple products to add.

The binding attribute is a common product attribute that links products together into a product with variants. The attribute must be of the SELECT type and have a GLOBAL scope.

Click on Add binding attributes (or on Binding attributes in the bar above the grid) to add a new one. A new window will appear.

Click on Add binding attribute and add one or more. If you do not have a binding attribute available, you need to create it first.

All added spaces for binding attributes must have an attribute selected before you can proceed.

Click on Choose attributes to save or Cancel to abort.

If you wish to change selected attributes, click on Binding attributes to the left of Add products. The number next to it shows how many binding attributes are selected.

The Add binding attributes window will open again. You can delete a binding attribute by clicking on the bin icon next to it.

The next step is adding products, so click Add products on the right side of the bar above the grid (or the same button below No product variants).

You can Select from list or Generate variants. Below you will find both options described.

Select from list

In the newly opened window, you will see a grid of products that have the binding attribute you selected earlier. Tick the products you wish to add and click Save changes to confirm or close this window to cancel. The number on the button shows how many products are ticked.

The products on the list are those that share the same binding attribute on the template assigned to them. This attribute must also have a value assigned for the product to appear on the list.

Product(s) will be added as a variant. The number on the Variants tab shows how many variants the product has, and the grid shows the value of each binding attribute in its own column. If you wish to open this variant (product), click on the eye icon.

To detach it, click on the remove (circled cross) icon.

Generating variants

There are some options to configure variant generation beforehand.

Generating SKUs for newly generated variants uses translations in the selected language if available; if not, codes are used as a fallback.

Option name
Description
Additional information

Binding attribute values

Specify the values of binding attributes from which product variants will be generated.

This field is required.

SKU format of the variant

Specify the SKU format of generated variants, it's based on the binding attribute values. SKU of variants will start with the parent SKU. A sample SKU of the variant is shown below the fields.

If there is more than one binding attribute, a user may change their order by dragging and dropping them, however, the parent SKU must always remain first .

Generate variant SKUs automatically

When generating variants, SKUs are always built from a hardcoded pattern (parent SKU + attribute values), bypassing the global Auto-SKU configuration (Settings > Product SKU settings). This setting changes this behavior.

Generate SKU automatically must be enabled in Settings.

Separator

A sign used as a separator in newly created variants' SKUs.

This field is required. Options: Dash (-), Underscore (_), Dot (.), Comma (,), Slash (/), No separator.

Language of attribute value

The language from which values will be taken to create the variant SKU.

This field is required.

Use parent product template

Automatically assign the template used in the parent product to newly created variants.

On by default. If turned off, it's possible to choose a different template from a drop down.

Product template

Allows to choose a different template to use with newly generated variants.

Shown only if Use parent product template is set as OFF.

Copy parent product categories

If ON, categories assigned to parent products are automatically assigned to newly generated variants.

Default: OFF

Category

Allows to pick categories to be copied.

Shown only if Copy parent product categories is set as ON.

Copy parent product attribute values

If ON, values of attributes from parent products are automatically copied to the same attributes in newly generated variants.

Default: OFF. If the user does not have sufficient attribute privileges (edit), (available with higher licenses), he may not see all available attributes. Also for an attribute to be visible, it must have a value in the main "mother" product.

Attribute values to be copied

Allows to choose which attribute values will be copied to newly generated variants.

Shown only if Copy parent product attribute values is set as ON.

Click on Generate variants to continue. The number on the button shows how many variants will be generated. A confirmation window will appear: click on Start batch action to confirm or Cancel to abort.

The generation of variants is done in the background. When the process is complete, users will be notified via the Action center.

Detach the product

To detach the product from the parent product, tick it in the grid and click on Detach variants in the bar above the grid.

Detached products are NOT deleted; they become single simple products. If you wish to delete the generated variant, you must first detach it and then delete it from the Product Catalog location.

Click on Start batch action to confirm or Cancel to abort.

Detaching variants is done in the background. When the process is complete, users will be notified via the Action center.

Last updated

Was this helpful?