Product Variants
Learn how to create variant products and assign custom attributes
If your product has multiple sizes, colors, or other variations, you can create variants from the Product Details page. For example, a running shoe might be offered in multiple sizes and colours. Each combination of color and size would correspond to a specific product variant.
Variants each have a corresponding Product ID, and require their own Stock Records. If your product has multiple variants you can think of them as separate products, in that they may have unique product details (including storefront styling, attributes, stock records and so on).
If your product has multiple sizes, colors, or other variations, you can create variants from the Product Details View.
Variants are defined by the specific attributes available to them, depending on the Product Class assigned when the product was added to the store.
To make an example, if you are planning to sell a t-shirt that comes in two sizes (small and large) and three colors (red, green, blue), you would first create the Product Class and define its variant attributes before adding the product to your catalogue.
- From the Products > Product Classes menu, add a new product class
- First give your new product class a unique name - in this case "T-Shirt"
Create New Product Class
- Next, create two product attributes: Color & Size
- For the Color product attribute,
- Set the Name field to “Color”
- Set the Code field to “color”
- Select “Option” for the Type field
If you are using variant attributes that match any listed below, use the example [bracketed value] for the Code field.
- pattern [pattern],
- material [material],
- color [color],
- age group [age_group],
- gender [gender],
- size [size]
- Click the (+) icon below the Option Group field to create a new attribute group with the attribute values you wish to use for your Product Class. This will open a pop up window to add the attribute group and attribute option values.
Create Attribute Option Group
In this case we’ll use “T-Shirt Color” for the Attribute Option Group details field, but you can define it by any name.
- Enter each of the individual Attribute Option values. In this example: red, green, blue. Then click Save. The Attribute Option Group you just created will be selected:
- Click Save and continue editing.
To add additional variant product attributes, click the Add Attribute button below the Product Attribute card, and repeat the above steps.
For example, to add a Size attribute to the T-shirt Product Class, create a “T-Shirt Size” Attribute Option.
- Click Save after adding all of the variant options.
With the product class now created, there are two ways to create a Product Variant:
- Or select an existing product and choose Add Variant from the Product Variants card on the Product Details View.
When creating a new product or variant, you will be prompted to select the new Product "T-Shirt" that was created:
Create Product (Choose Product Class)
- Give your new Product a Title, and from the Variant Attributes card select the product attributes to make available for selection on its variants.

Create Product - Variant Attributes
- Click Save.
Now your Product “parent” is saved. Next scroll down to the Product Variants card and click the Convert to variant product button.

Convert to Variant - Product Details View
Once the Product is converted to a variant product, you can edit or add variant products from the Product Variants card:

Variant Product Created - Product Details View
You can now select the Variant from the Product Variants card to view and assign the available variant attributes on the Attributes card.

Variant Details View
Last modified 1mo ago