Variants let you offer multiple versions of the same physical product (for example, a T-shirt in three sizes and two colors), where each combination can have its own price, discounted price, stock quantity, low-stock alert level, SKU, barcode, weight, and offer quantity.
Where to find variants
The variant builder is located inside the Product information tab of any physical product, below the price fields. Once you add at least one variant group with at least one option, the individual price and stock fields move from the main form to each variant combination row.
Variant groups
Each variant group represents one dimension of variation (for example, Size, Color, or Material). For each group you set:
- Variant name: Required. The label shown to customers (for example, "Size" or "Color"). Must be unique among groups on this product.
- Variant type: Required. Choose one of:
- Text: Option displayed as a text button (for example, "S", "M", "L").
- Color: Option displayed as a color swatch. Each option requires a valid color value.
- Image: Option displayed as a small image thumbnail. Each option requires an image from your media library.
You can add multiple variant groups. All possible combinations are generated automatically, for example, 3 sizes × 2 colors = 6 variant rows.
Variant options
Under each group you add individual option values. Rules:
- Each option needs a value (required, non-empty, unique within the same group).
- Color type: also requires a color picker selection. An empty or invalid color is rejected.
- Image type: also requires an image from your media library. The image must belong to your store.
- A group with no options is automatically removed when you save.
Variant position
The Position setting (top or bottom) controls where the variant selector appears on the product page relative to the add-to-cart button. Default: top.
Per-variant fields
For each combination row you can set:
- Price: Required. Your selling price for this combination, rounded to 2 decimal places.
- Discounted price: Optional. Must be strictly lower than the variant's price, rounded to 2 decimal places.
- Available quantity: Optional. A whole number from 0 to 999,999. Leave empty for unlimited (untracked) stock.
- Minimum quantity to alert: Optional. A whole number from 1 to 999,998. Must be strictly less than the available quantity, and requires the available quantity to be set first.
- SKU: Optional. Maximum 70 characters.
- Barcode: Optional. Maximum 50 characters.
- Weight: Optional. Any decimal number. The unit matches your store's weight setting.
- Offer quantity: Optional. A whole number from 1 to 999. Used for bundle quantity-break offers.
- Default: Mark one combination as the default so it is pre-selected when the product page loads.
How combination rows are counted
The number of variant combination rows must equal the total number of possible combinations across all your groups. For example, if you have a group with 3 options and another with 2 options, Storeep expects exactly 6 rows. A mismatch will cause the save to fail.
How prices flow to markets
Each variant combination has its own base price and base discounted price in your store currency. When you add the product to a market, Storeep calculates that market's price using the current exchange rate. You can override the calculated price for any non-primary market from Settings → Markets. See Pricing and discounts.
Things to watch out for
- Variant group names must be unique within the product. Two groups both named "Size" will cause a save error.
- Option values must be unique within their group. Two options with the same label in one group are not allowed.
- For color variants, the color picker must have a valid color selected. An empty swatch causes a validation error.
- For image variants, the image must already be in your media library before you can assign it.
- If you set a Minimum quantity to alert for a variant without setting its Available quantity, the save fails with a message asking you to enter the available quantity first.
- Removing a variant group after the product has been saved will delete all stock and sales data for the removed combinations. Re-adding a group generates new empty rows.