Product variants
The product variants functionality defines how variations of a product are structured and managed in the catalog. Variants enable flexible handling of product attributes such as size, color, fit, or material — essential for both B2C and B2B use cases.
Primary methods for managing variants
Two methods are available for handling variants:
- Multiple SKUs on a single product.
- A Variant Group that connects separate products.
Every product must have at least one SKU. A product can also include multiple SKUs (e.g., S, M, L for fashion). Stock and warehouse shelf locations are managed at the SKU level.
A Variant Group links individual products and lets you specify one or more variant dimensions on the connection (e.g., color: red; fit: slim). You can designate a main product for the Variant Group and collapse product listings to show only the main product.
Key configurations
| Type | Description |
|---|---|
| SKU | Unique identifier for a specific product variation. Required for all products. |
| Variant dimensions | Attributes that differentiate variants, such as size, color, or fit. |
| Variant group | A group that connects several variants of the same product. |
| Main product | The designated product representing the variant group in listings. |
| Inventory link | Connects stock data and shelf locations at the SKU level. |
Typical use cases
The product variant functionality enables a variety of use cases, providing flexibility in catalog structure and merchandising control.
1. Managing simple variants on a single product
Handle multiple SKUs (e.g., sizes) directly on one product entry.
Examples include:
- Managing stock levels per size (S, M, L).
- Displaying all available sizes under a single product detail page.
2. Grouping multiple products as variants
Link related products together via a variant group for cleaner storefront presentation.
Examples include:
- Connecting color variants (red, blue, green) as part of the same product family.
- Displaying a single main product with selectable color options.
3. Combining both methods for advanced catalogs
Use both SKU-level and product-level variants for complex products.
Examples include:
- Color variants as separate products, each with its own set of size SKUs.
- Managing warehouse stock per SKU while showing one unified product in the storefront.
Related functionality
| related feature | description |
|---|---|
| products | Base entity for catalog structure. Variants extend product data and relationships. |
| inventory / stock | Stock management occurs at the SKU level, connected to each variant. |
| pricing | Supports per-variant or per-SKU pricing logic. |
| media and assets | Variant-specific images or media can be assigned (e.g., color photos). |
| PIM integration | Enables external product data synchronization for variant management. |