In this section · 3 articles

Create variants with the variant matrix

Create every version of a product at once, such as each size and color of a T-shirt, each with its own SKU, by picking values on the variant matrix.

Applies to
Product Catalog 1.3 and later
Who can do this
Platform owner, Administrator, Team member
Permission
feature.pcat.variant.bulk_generate
Where
Catalog › Products
On this page

A variant is one version of a product that's stocked or sold on its own, with its own SKU: the red T-shirt in size M, for example. Variants are made from attributes marked as variant axes, such as Size and Color, and their values, such as S, M, L. The variant matrix creates one variant for every combination of the values you pick.

Before you start

  • You need List Variant (feature.pcat.variant.list) to open the matrix, View Variant (feature.pcat.variant.view) to preview, and Generate Variant Matrix (feature.pcat.variant.bulk_generate) to create variants.
  • Your catalogue needs at least one attribute marked as a variant axis, with values. Product Catalog 1.4.0 has no screen for creating attributes. Ask your platform owner how attributes are loaded.

Steps

  1. In the sidebar, open Catalog › Products.

  2. In the product's row, select Variant matrix.

    If you see No variant axes are defined yet, no attribute is marked as a variant axis. See Before you start.

  3. For each axis, select the values you want, or Select all. Clear removes your choice for that axis.

  4. Check What this would create:

    • Combinations: how many variants your choice makes.
    • Already exist: combinations the product already has. They're left alone.
    • To be created: the new variants.
  5. Select Generate variants.

  6. Confirm Create n variants? Existing ones are left alone.

    The Generate variants confirmation asking "Create 6 variants? Existing ones are left alone.", with Cancel and Confirm buttons.

You see n variants created. The product's Variants setting switches to Has variants.

How SKUs are made

Each new variant gets a SKU from the product's slug and the values' codes, in capitals: classic-tshirt in red, size M becomes something like CLASSIC-TSHIRT-RED-M. If that SKU is taken, even by a deleted variant, a number is added. After five tries you see Could not find a free SKU based on SKU after five attempts.

Limits

  • One generation can create at most 500 variants. Above that, the matrix shows That is more than 500 variants. Narrow the selection, or generate in stages. Pick fewer values, generate, then pick the rest.

    The Variant matrix's What this would create panel showing 540 combinations to be created, with the warning "That is more than 500 variants. Narrow the selection, or generate in stages."
  • Each combination exists only once per product, so running the matrix again only adds what's missing.

After generating

The first variant a product gets becomes its default variant. Its SKU is the one shown on CRM quote lines for the product.

Product Catalog 1.4.0 has no screen for editing, pricing or deleting single variants, or for choosing a different default variant.