Skip to main content

Generate variants for a matrix product

A matrix product groups the variations you sell, such as a shirt in three sizes and four colors. Generate Variants creates those variations for you: you pick up to three attributes and their values, and SKU.io creates one variation for every combination, with its SKU, name and attribute values filled in.

Before you begin​

  • The product's type is Matrix. The Variations card, and the button on it, only appear on matrix products. See Create a product.
  • Your role has the Products Variants permission (products.manage_variants). Without it, Generate Variants is hidden.
  • The attributes you want to vary by, such as Size and Color, exist in your catalog. The values don't have to: you type them in the dialog. See Manage attributes.

Steps​

  1. Open the matrix product. It opens on the Overview tab.

  2. On the Variations card, click Generate Variants. The Generate variants dialog opens with the product's name in its title.

  3. Under Attribute 1, pick the first attribute, for example Size.

  4. In Values, type a value and press Enter. Repeat for each value, for example S, M and L. Click the × on a chip to remove a value.

  5. To vary by a second attribute, click Add another attribute and fill in its attribute and values. You can add up to three. Click the × at the end of a row to remove it.

  6. Check the SKU pattern. It starts as the product's SKU followed by -{v1}. {v1}, {v2} and {v3} stand for the values of the first, second and third attribute, and {parent_sku} for the matrix product's SKU. For example, {parent_sku}-{v1}-{v2} on a product with SKU TEE gives TEE-Red-L.

  7. Click Preview combinations. The preview lists every combination with its SKU and Status:

    • Will create: a new variation.
    • Exists: the product already has a variation with these values, so it's skipped.
    • Duplicate: two combinations would get the same SKU.

    The line under the count adds them up, for example 6 new · 0 exist already · 0 excluded.

  8. If the preview shows Duplicate, click Back and change the SKU pattern so each combination gets its own SKU, usually by adding the missing placeholder. You can't generate until no duplicates are left.

  9. To leave a combination out, untick its row. Untick the box in the header to clear every row, and tick it again to select them all.

  10. Click Generate with the number of variations, for example Generate 6 variant(s). The dialog shows Variants generated with how many were created, skipped and failed.

  11. Click Close. The new variations appear in the Variations card.

What each variation gets​

FieldValue
SKUBuilt from the SKU pattern. Values keep their case, and spaces and punctuation are removed, so Sky Blue becomes SkyBlue.
NameThe matrix product's name, a dash, and the values, for example Classic Tee — Red / L.
TypeStandard, so each variation holds its own stock.
StatusThe same as the matrix product's.
AttributesOne value for each attribute you picked.

The attributes you used are also saved on the matrix product as the attributes its variations differ by. They become its Attributes to Compare, and publishing uses them to build a channel's variant options, for example the options on a Shopify product.

Variations are created without a price, barcode, weight, images or supplier. Open a variation from the Variations card to fill those in.

Limits​

  • Up to three attributes per run. Run it again to add more combinations later; combinations that already exist are skipped.
  • Each value and the SKU pattern can be up to 120 characters.
  • SKUs must be unique across your whole catalog. The preview only checks the new combinations against each other, so a SKU that another product already uses shows as Will create, then counts as failed when you generate. Change the pattern and run it again.

Set prices before you publish​

A variation's price on a channel comes from its own prices, not the matrix product's. Shopify, for example, gets each variant's price in your default pricing tier at the first publish, and leaves out a price of zero. So give every variation a price before you publish:

  • For a few variations, open each one from the Variations card and set its price on the Pricing tab. See Set a product's price.
  • For many, select the variations on the products list and use Bulk Edit to set a pricing tier's value. See Bulk-edit products.

Next steps​

Last verified: