Catalog & productsUpdated 2026-06-01
Product variants & colors
Offer size, color, and material options without creating separate products.
Variants let a single product offer multiple option combinations — like sizes and colors — each with its own SKU, price, and stock.
How variants work
On the product form, the Variants section lets you define option groups (e.g. Size with values S, M, L) and colors. Each combination becomes a distinct variant the shopper can select on the product page.
Variant fields
| Field | Type | Description |
|---|---|---|
| option groups | string[][] | Named option groups like Size or Material, each with a set of values. |
| colors | Color[] | Named colors with hex values, rendered as swatches on the storefront. |
| sku | string | Per-variant SKU, unique per shop. |
| price | number | Optional per-variant price override. Falls back to the product base price. |
| stock | number | Per-variant stock quantity. |
Storefront rendering
The storefront product page renders option groups as buttons/dropdowns and colors as swatches. Selecting a combination updates the displayed variant, price, and stock.
Related