Product Variations


Product variations are a part of the add-on with the same name.

Variations are similar products that differ from each other only in one or a few features, for example: “green M-sized T-shirt” and “red S-sized T-shirt”. This kind of product requires 3 things:

  1. Let customers choose the feature values on the product page.

  2. Show some of the variations (for example, different colors) as separate catalog items. That way customers will see the color they need on the product list.

  3. Hide some of the variations (for example, sizes) from the product list. That way customers wouldn’t be confused by multiple T-shirts of different sizes with the same image.

    Switching between product variations on the storefront.


Variation group—a few similar products that differ from each other only in one or several features.

Variation—a product that belongs to a variation group. A product can belong only to one group at the same time, but it’s easy to change the product’s group. If a variation is removed from the group, it becomes a standard product.

Catalog item—a single spot on the product list. Until variations existed, “catalog item” meant the same thing as “product”. But now variations may or may not occupy a place on the product list, hence the new term.


Every variation is a product, but not every product is a variation. Use the Advanced search on the product list in the admin panel. For example, it can let you find only variations, or only catalog items.

A T-shirt comes in 3 colors, and each color has 5 sizes. That means 15 products. If we want to add switching between these products, we’ll put these products into a variation group that is based on the “Color” and “Size” features. Now we have 15 variations, and customers can switch between them on the product page.

Depending on how your features are configured, these 15 variations can be:

  • 1 catalog item—the color and size selection is available only on the product page.

  • 3 catalog items—T-shirts of different colors appear on the storefront as separate products, but sizes can be selected only on the product page.

  • 5 catalog items—if someone decides to show sizes on the product list and leave the color selection on the product page. It doesn’t suit T-shirts, but may be appropriate for other products.

  • 15 catalog items—when colors and sizes appear on the list as separate products; every variation has its own catalog item.


    This scheme works even when the number of features is more than two. You can edit the features at any time, but the number of catalog items will change only if you disband and recreate the variation group. More on that below.

Working with Variations

Creating a New Variation Group

Let’s say you have added a new product to your store, and now you want to create variations for it. You can do it right on the product page:

  1. Open the Variations tab on the page of the product.

  2. Click Add variations.

  3. Enter a name of a feature in the Create new products tab. If a feature exists in your store, you’ll be offered to use it.


    Not all the features appear among suggestions. It depends on what Purpose has been specified in the features’ settings.

    If the feature does not exist yet, click Add and specify one of the two Purposes for it. Specified purpose determines whether variations with different feature values will occupy separate positions in the list.

  4. Add Variants for your features.

  5. Click Create. The variations will be generated automatically.

    Adding new variations from the product page

Сombining Products into a Variation Group

Let’s say you have imported products to your store, and now you want to put some of them in one group. It will allow your customers to choose a product while switching between the variations, and not to get confused by identical products with different feature variants. To do this:

  1. Open the Variations tab on the product editing page.

  2. Click Add variations.

  3. Go to the Use existing products tab. You can see all of the identical products here.


    The list will display the products that meet three following conditions:

    • same category;
    • same features, but different variants;
    • appropriate Purposes specified in the features’ settings.
  4. Select the products you need, and click Add variations.

    Creating a new variation group based on the existing products

Management and Removal

Once a variation group is created, all products from the group will appear on the Variations tab of any product in the group. On this tab you can:

  • See which variations have their own catalog item, and which don’t. A variation that doesn’t appear on the product list has a smaller icon.

  • Choose which of the variations to display by default as the catalog item.


    Other variations will borrow many of their properties from the variation that is selected as default.

  • Remove a variation from the group; this will turn the variation into an independent product.

  • Delete the variation.

  • Change the group code—you can use it later to add other products to this group as variation. A group code can contain only digits, Latin characters, and the following signs: - and _.

  • Add more variations to the group.

  • Switch to the product list to edit variations there—that way you’ll be able to edit and remove variations in bulk.

  • Disband the group—turn all its variations into independent products and remove the ability to switch between them on the product page.

    Catalog items have bigger pictures than variations that can be selected only on the product page.