Skip to main content

Variants & combinations

Variants let one product cover multiple options — colors, sizes, materials, capacities, …

🎬 Video​

The variant model​

ConceptDefinition
Variant groupA category of choices (Color, Size, Material)
Variant optionA specific value within a group (Red, Blue, Small, 64GB)
CombinationA specific cross-product of options (Red + Small, Red + Large, …)

A product with 3 colors × 4 sizes has 12 combinations.

Three types of variant groups​

1. Color (visual swatches)​

Pick a hex code. Storefront shows colored circles. Best for clothing, accessories, electronics.

2. Text​

Plain text labels (S, M, L, XL). Best for sizes, capacities, materials.

3. Image-text​

Each option has an image + a text label. Best for "Brand", "Style", "Pattern".

Per-option overrides​

Each option in a group can have:

  • Price adjustment — e.g., XL = +200 DA
  • Stock count — independent of base product stock
  • Image override — show a different image when this option is selected

Per-combination stock​

If you have 3 colors × 4 sizes and want to track stock for each combination (e.g., "Red Large" has 2 units, "Red Small" has 5), enable Per-combination stock in the variant editor. The Stock Management add-on adds bulk-set, low-stock alerts, and combination CSV import.

Cascading variants​

Some catalogs have dependent options — Brand → Model. Selecting "iPhone" should only show iPhone models, not Samsung. For this, install the Cascading Variants add-on.

Variant pickers in the storefront​

The default theme renders a clean picker per group. For a 2-step accordion UI on the Digital theme (single-selection across groups, prices on each option), install Digital Product.

Adding variants to a product​

  1. Open the product editor.
  2. Scroll to Variants.
  3. Click Add group → pick type (Color/Text/Image-text), name it.
  4. Click Add option for each value.
  5. (Optional) Toggle Per-combination stock to track each combination.
  6. Save.

Bulk operations on variants​

  • CSV import — upload a CSV with combination_label, price_delta, stock columns.
  • Bulk price — apply a delta to all combinations under a group.
  • Bulk stock — set the same stock count to all combinations.

Frequently asked​

Q: I have 4 groups × 5 options each = 625 combinations. Will the dashboard be slow? A: We optimize up to ~1000 combinations. Beyond that, contact support to discuss schema changes.

Q: Can different combinations have different images? A: Yes — use the per-option image override on the most-visible group (usually Color).

Q: How do I show "out of stock — Red size XL" but other combinations available? A: Enable Per-combination stock. The storefront greys out unavailable combinations.