Skip to content

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:

ScenarioBetter approach
Completely different productsCreate separate Standard products
Products with only price differencesUse separate Standard products with different names
Digital products with tiersCreate separate Virtual products
Bundles or kitsUse related products

How Variants Work

Variants are built from attributes, structured properties you define for your products. Here's the flow:

  1. Create a Variant product
  2. Attach attributes to the product (e.g., Size, Color)
  3. Each attribute has values (Size: S, M, L / Color: Red, Blue)
  4. Generate variants from all combinations
  5. 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):

VariantSKUPriceStock
S / RedTSH-S-RED$29.9925
S / BlueTSH-S-BLU$29.9930
S / BlackTSH-S-BLK$29.9920
M / RedTSH-M-RED$29.9940
M / BlueTSH-M-BLU$29.9935
M / BlackTSH-M-BLK$29.9945
L / RedTSH-L-RED$32.9920
L / BlueTSH-L-BLU$32.9925
L / BlackTSH-L-BLK$32.9930
XL / RedTSH-XL-RED$34.9915
XL / BlueTSH-XL-BLU$34.9920
XL / BlackTSH-XL-BLK$34.9910

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

  1. Open your variant product's Attributes tab
  2. Click Choose attributes
  3. 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
  4. 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
  5. Click Save. The values you picked become the options for variant generation
Product Attributes for Variants

Generating Variants

Once attributes are attached, you can generate all variant combinations automatically.

Automatic Generation

  1. Go to the Variants tab on your product
  2. Click Generate variants. The button only shows once the product has attribute values
  3. Shopper calculates all possible combinations from your attribute values
  4. 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
  5. 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
  6. Click Save to create all variants at once
Generate Variants

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:

  1. Go to the Variants tab
  2. Click Add variant
  3. 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.

Variants List

Variant Properties

Each variant can have its own:

PropertyDescription
NameDescriptive name (filled in from the attribute values when you generate variants)
SKUStock keeping unit for this specific variant, unique within the product
BarcodeUnique barcode (UPC, EAN) for this variant
Price amountDifferent pricing per variant and per currency
Compare at priceShow original price for discounted variants
Cost per itemYour cost for this variant (for margin calculations)
QuantityStock level for this specific combination, per inventory location
Thumbnail and ImagesImages showing this color or option
Package dimensionWidth, height, weight, volume and depth, if they vary by size
Allow backorderWhether to accept orders when out of stock
PositionThe 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:

Edit Variant
  • 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):

  1. Find the variant in the list on the Variants tab
  2. Click the delete icon on its row. To delete several variants, select them and choose Delete from the bulk actions
  3. 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).

Variant Product Shipping

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:

Variant Selection on Storefront

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:

  1. Type: Select "Variant"
  2. General info: Name "Classic Cotton Hoodie", describe the material and fit
  3. Associations: Brand "UrbanWear", categories "Clothing > Hoodies", collection "Fall Collection"
  4. Media: Upload lifestyle photos showing different colors
  5. Stock & Inventory: SKU for parent product HOOD-CLASSIC (variants will have their own SKUs)

After creation:

  1. Attributes: Attach "Size" (S, M, L, XL) and "Color" (Navy, Gray, Black)
  2. Generate variants: Creates 12 combinations automatically
  3. Pricing: S/M at $59.99, L/XL at $64.99
  4. Stock: Set quantities per variant based on your inventory
  5. Images: Upload color-specific photos for each color variant
  6. 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