Variants let you sell multiple versions of one physical product (for example, a T-shirt in three sizes and two colors). Each combination can carry its own price, discounted price, available quantity, low-stock alert, SKU, barcode, weight, and offer quantity. Variants are available on physical products only, not on digital products.
Where to find variants
Open a physical product from the Products page (or create one with Add product). The variant builder lives in the Product information tab, just below the main price and stock fields. As soon as you add one variant group with at least one option, Storeep moves the price and stock inputs out of the main form and onto each generated combination row.
Variant groups
Each group is one dimension of variation (Size, Color, Material). You can add up to 3 groups per product. For each group you set:
- Variant name: required, up to 50 characters, and unique among the groups on this product. Two groups both named "Size" cause a save error.
- Variant type: pick one of three display styles using the icon radios:
- Text: each option shows as a text button (for example S, M, L).
- Color: each option shows as a color swatch and needs a valid color value.
- Image: each option shows as a thumbnail and needs an image that already exists in your store media library.
Storeep generates every combination automatically, so 3 sizes by 2 colors produces 6 rows.
Variant options
Under each group you add the individual option values. Up to 50 options per group. Rules:
- Each option needs a Variant value (required, up to 50 characters, unique within the same group).
- Color type: also needs a color chosen in the picker. An empty or invalid color is rejected.
- Image type: also needs an image that belongs to your store. A reference that is not in your media library is rejected.
- A group with no options is removed automatically when you save.
Variants positioning
The Variants positioning setting (Top or Bottom) controls whether the variant selector appears above or below the rest of the product details on the storefront. The default is Top.
Per-combination fields
Click a combination row to expand its inputs. For each row you can set:
- Default: mark one combination as default so it is pre-selected when the product page loads.
- Price: required. Your selling price in your store currency, kept to two decimal places.
- Discounted price: optional. Must be strictly lower than this row's price, kept to two decimal places.
- Available quantity: optional whole number from 0 to 999,999. Leave it empty for unlimited (untracked) stock.
- Minimum quantity to alert: optional whole number from 1 to 999,998. It must be lower than the available quantity, and the available quantity must be set first.
- Sku: optional, up to 70 characters.
- Barcode: optional, up to 50 characters (ISBN, UPC, GTIN, MPN, and similar).
- Weight: optional decimal. The unit follows your store weight setting (kg, g, lb, or oz).
How prices flow to markets
Every combination stores its own base price and base discounted price in your store currency. When the product is added to a market, Storeep derives that market's price from the base using the market exchange rate. You can override the calculated price for any non-primary market from Settings, Markets, then the market, then Products, then Edit for that product. See the Pricing and discounts article for the full per-market flow.
Things to watch out for
- Group names must be unique within the product, and option values must be unique within their group.
- The number of combination rows must match the total number of possible combinations across your groups. A mismatch makes the save fail.
- Color variants need a valid color in the picker; an empty swatch fails validation.
- Image variants must use an image already in your media library before you can assign it.
- Setting a Minimum quantity to alert without an Available quantity fails the save and asks you to enter the available quantity first.
- Removing a group after saving deletes the stock and the rows for those combinations. Re-adding a group generates new, empty rows.