Variant Product
Products with multiple options like size, color, or material, where each combination becomes a unique variant.
A variant product is a physical item that comes in multiple options. Instead of creating separate products for each size or color, you create one parent product and generate variants for every combination. Each variant has its own SKU, price, stock level, and image.
When to Use Variant Products
Use the Variant product type when:
- A product comes in multiple sizes (S, M, L, XL, XXL)
- A product is available in different colors (Red, Blue, Black)
- A product has different materials (Cotton, Polyester, Silk)
- A product has capacity options (64GB, 128GB, 256GB)
- Any combination of the above (Size + Color, Color + Material, etc.)
Do NOT use variants when:
| Scenario | Better approach |
|---|---|
| Completely different products | Create separate Standard products |
| Products with only price differences | Use separate Standard products with different names |
| Digital products with tiers | Create separate Virtual products |
| Bundles or kits | Use related products |
How Variants Work
Variants are built from attributes, structured properties you define for your products. Here's the flow:
- Create a Variant product
- Attach attributes to the product (e.g., Size, Color)
- Each attribute has values (Size: S, M, L / Color: Red, Blue)
- Generate variants from all combinations
- Configure each variant (price, stock, image)
Example: T-Shirt with Size and Color
Attributes:
- Size: S, M, L, XL
- Color: Red, Blue, Black
Generated variants (12 total):
| Variant | SKU | Price | Stock |
|---|---|---|---|
| S / Red | TSH-S-RED | $29.99 | 25 |
| S / Blue | TSH-S-BLU | $29.99 | 30 |
| S / Black | TSH-S-BLK | $29.99 | 20 |
| M / Red | TSH-M-RED | $29.99 | 40 |
| M / Blue | TSH-M-BLU | $29.99 | 35 |
| M / Black | TSH-M-BLK | $29.99 | 45 |
| L / Red | TSH-L-RED | $32.99 | 20 |
| L / Blue | TSH-L-BLU | $32.99 | 25 |
| L / Black | TSH-L-BLK | $32.99 | 30 |
| XL / Red | TSH-XL-RED | $34.99 | 15 |
| XL / Blue | TSH-XL-BLU | $34.99 | 20 |
| XL / Black | TSH-XL-BLK | $34.99 | 10 |
Setting Up Variant Attributes
Before generating variants, you need to attach attributes to your product.
Prerequisites
Make sure you have created the necessary attributes in the Attributes section. Variant-compatible attributes typically use these field types:
- Select. A dropdown list of values. You add one value to the product at a time
- Color picker. Visual color selection. You can add several values at once
- Checkbox. Multiple selectable values. You can add several values at once
Attributes of type text, number, rich text or date are not used to generate variants.
Adding Attributes to Your Product
- Open your variant product's Attributes tab
- Click Choose attributes
- In the Attributes step of the panel, select the attributes you want to use for variants (e.g., Size, Color), then go to the next step
- In the Values step, pick the values this product comes in (e.g., S, M, L). A Select attribute takes one value at a time: click Choose attributes again to add the next one
- Click Save. The values you picked become the options for variant generation

Generating Variants
Once attributes are attached, you can generate all variant combinations automatically.
Automatic Generation
- Go to the Variants tab on your product
- Click Generate variants. The button only shows once the product has attribute values
- Shopper calculates all possible combinations from your attribute values
- Review the list in the Generate variants panel. Each combination is a row with a Name (required, filled in from the values), a SKU (Stock Keeping Unit) made from the product SKU and the values, a Price and a Stock number value. Rows marked New are variants that do not exist yet
- Edit the name, SKU, price and stock as needed. To leave out a combination you do not sell, click the delete icon on its row. If that combination is an existing variant, the variant is deleted when you save
- Click Save to create all variants at once

The Price field in this panel does not convert decimals: type the amount in cents, for example 15000 for 150.00. It sets the price in your default currency only. To enter prices with decimals or in other currencies, leave it at 0 and use the Product pricing section on each variant's page.
The number of variants equals the product of all attribute value counts. For example: 4 sizes x 3 colors = 12 variants. Keep this manageable, too many combinations can be hard to maintain.
Adding Individual Variants
You can also add variants one at a time:
- Go to the Variants tab
- Click Add variant
- Fill in the variant details step by step, then click Save
The individual variant creation wizard has 4 steps:
Step 1: General
- Name of the variant (required)
- SKU (must be unique within the product)
- One value for each of the product's attributes, under Variant attributes. If another variant already uses the same values, the panel shows "This variant already exists!" and you cannot save
Step 2: Media
- Thumbnail for this variant
- Additional Images for this variant
Step 3: Pricing
- Price amount per currency
- Compare at price
- Cost per item
Step 4: Inventories
- Barcode
- Quantity, added to your default inventory location
Managing Variants
After generation, you can manage each variant individually. The Products variations list on the Variants tab shows each variant's thumbnail, name, SKU, position and current stock.

Variant Properties
Each variant can have its own:
| Property | Description |
|---|---|
| Name | Descriptive name (filled in from the attribute values when you generate variants) |
| SKU | Stock keeping unit for this specific variant, unique within the product |
| Barcode | Unique barcode (UPC, EAN) for this variant |
| Price amount | Different pricing per variant and per currency |
| Compare at price | Show original price for discounted variants |
| Cost per item | Your cost for this variant (for margin calculations) |
| Quantity | Stock level for this specific combination, per inventory location |
| Thumbnail and Images | Images showing this color or option |
| Package dimension | Width, height, weight, volume and depth, if they vary by size |
| Allow backorder | Whether to accept orders when out of stock |
| Position | The variant's place in the variant list. Use the reorder button above the list and drag the variants into order |
Editing a Variant
Click the Edit icon on a variant's row to open the variant's own page, titled with its name. From there you can update:

- The name, Allow backorder, the attribute values and the Package dimension: click Edit in the Variant information section
- All pricing fields, per currency, in the Product pricing section, the same way as for a product
- The SKU and barcode: click Edit in the Inventories section
- Stock levels: in the Quantity Inventory list, click Update, select the Inventory name and enter the Quantity to add (50) or remove (-5)
- Variant-specific images: click Edit in the Media section to change the Thumbnail and Images
Deleting Variants
If you discontinue a specific option (e.g., removing the "XS" size):
- Find the variant in the list on the Variants tab
- Click the delete icon on its row. To delete several variants, select them and choose Delete from the bulk actions
- Confirm the deletion
Deleting a variant is permanent and removes its images, prices and stock history. If a variant is temporarily unavailable, set its stock to 0 instead.
Variant Pricing Strategies
Same Price for All
All variants at the same price point:
- Basic t-shirt: All sizes and colors at $29.99
Price by Size
Larger sizes cost more due to material usage:
- S/M: $29.99
- L/XL: $34.99
- XXL: $39.99
Price by Option
Premium options at a higher price:
- Standard colors (Black, White, Gray): $49.99
- Limited edition colors (Gold, Rose): $59.99
Per-Variant Pricing
Each combination has its own price:
- Useful for products where cost varies significantly by option
Shipping for Variant Products
Variant products have package dimensions at both levels:
- Parent product: the Package dimension section of the Shipping tab
- Individual variants: the Package dimension fields behind Edit in the Variant information section of each variant's page
With the starter kits, shipping rates use the dimensions of the variant in the cart. The parent product's dimensions are not copied to its variants, so fill them in on each variant (e.g., XL is heavier).

Inventory Per Variant
Stock is tracked individually for each variant:
- Each variant has its own quantity per inventory location
- The products list shows the total stock across all variants, for example "in stock for 12 variant(s)"
- Safety stock is set on the parent product only. Variants have no safety stock level, and Shopper sends no alert when a variant runs low
- With the starter kits, an option whose variants have no stock (and do not allow backorder) cannot be selected, while the other options stay purchasable
Storefront Display
On your storefront, variant products display option selectors that let customers choose their preferred combination:

When a customer selects different options:
- The price shows the selected variant's price, or the product price when the variant has none
- The images stay those of the product: the starter kits do not show variant images on the product page
- Availability: options with no stock and no backorder cannot be selected. The Vue and React starter kits also show an "Out of stock" badge
- The Add to Cart button: in the Vue and React starter kits it stays disabled until every option is chosen, and reads "Out of stock" when the selected variant has no stock. The Livewire starter kit keeps it active and shows a message when an option is missing or stock is too low
Example: Creating a Variant Product
Let's create a "Classic Cotton Hoodie" with Size and Color options:
- Type: Select "Variant"
- General info: Name "Classic Cotton Hoodie", describe the material and fit
- Associations: Brand "UrbanWear", categories "Clothing > Hoodies", collection "Fall Collection"
- Media: Upload lifestyle photos showing different colors
- Stock & Inventory: SKU for parent product
HOOD-CLASSIC(variants will have their own SKUs)
After creation:
- Attributes: Attach "Size" (S, M, L, XL) and "Color" (Navy, Gray, Black)
- Generate variants: Creates 12 combinations automatically
- Pricing: S/M at $59.99, L/XL at $64.99
- Stock: Set quantities per variant based on your inventory
- Images: Upload color-specific photos for each color variant
- Shipping: Weight 0.5 kg for S/M, 0.6 kg for L/XL
Best Practices
Limit Combinations
Keep variant count manageable. 3 sizes x 3 colors (9 variants) is easier to manage than 6 sizes x 8 colors (48 variants).
Unique SKUs
Use a consistent SKU pattern: PRODUCT-SIZE-COLOR (e.g., HOOD-M-NAV).
Color-Specific Images
Upload variant-specific images for color options. The starter kits show the product's own images on the product page, so ask your developer if you want variant images shown.
Watch Best Sellers
Check the stock of your popular variants often: Shopper sends no alert when a variant runs low.
Limitations
- There is no fixed limit on variant attributes (e.g., Size + Color + Material), but each one multiplies the number of variants
- The total number of variants is the product of all attribute values
- Consider splitting into separate products if you exceed 50+ variants
- Product type cannot be changed after creation, so plan ahead
For developer details, see the Product Variants documentation.
Last updated on
Edit on GitHub




