Variants
Overview
A variant is a specific version of a product that's sold with its own SKU, price, and — where applicable — its own stock. Every product in the Sales Catalog has at least one variant: the default variant, which is created together with the product. If you sell the same product in different presentations (sizes S/M/L, colors, flavors, capacities), you add additional variants so the AI agent and your reports distinguish them correctly.
How to Access
- Variants are managed from the product detail page (
/sales/products/:id). - Required role: Administrator.
Interface Overview
The Variants section inside the product detail shows:
- The default variant (the first one, always present), tagged as Default.
- The additional variants, each with name, SKU, price, currency, and — if applicable — available stock.
- Buttons to add, edit, and remove additional variants.
The default variant is the one shown as the "from" price in the list and the one the AI agent takes as the reference when describing the product in general terms.
Features & Actions
Add a variant
What it does: Creates an additional variant on the product.
Steps:
- Open the product detail page.
- Go to the Variants section.
- Click Add variant.
- Fill in the fields: variant name (e.g., "Size M"), SKU, price, currency, initial stock (if applicable).
- Click Save.
Important notes:
- Each variant's SKU must be unique across your entire account.
- The variant name is optional but recommended so the AI agent can refer to it clearly ("Size M", "Color red", "1 L presentation").
- If the product has the Track inventory flag enabled, each variant keeps its own stock count.
Edit a variant
What it does: Modifies the SKU, price, currency, name, or stock of an existing variant.
Steps:
- Open the product detail page.
- In the Variants section, click the edit icon on the corresponding row.
- Adjust the fields.
- Save the changes.
Change the default variant
What it does: Designates another variant as the product's primary one.
Steps:
- In the variants list, open the actions menu of the variant you want to make default.
- Select Set as default.
- The previous default loses the tag and the new one takes it.
Important notes:
- The default variant is the one used as the price reference in the list, in imports, and in the AI agent's general response when the customer hasn't specified a particular variant.
Remove a variant
What it does: Removes an additional variant from the product.
Steps:
- In the Variants section, click the remove icon.
- Confirm the removal.
Important notes:
- You cannot remove the default variant. If you want to replace it, first set another variant as default.
- Removing a variant with sales history or active bookings may not be allowed; consider archiving the product instead.
Fields Reference
| Field | Description | Required | Notes |
|---|---|---|---|
| Variant name | Visible label (Size M, Color red, etc.) | No | Recommended for distinguishing variants |
| SKU | Unique identifier | Yes | Unique across the entire account |
| Price | Price per unit | Yes | Zero or greater |
| Currency | 3-letter ISO code | Yes | USD, MXN, BRL, etc. |
| Initial stock | Inventory when the variant is created | No | Only when the product tracks inventory |
| Default variant | Primary-variant tag | — | Exactly one per product |
Important Notes
- The AI agent can recommend a specific variant if the customer asks for a feature ("size M"), as long as the variant name is descriptive.
- When the agent returns a product in search, it shows the "from" price — the default variant's — and lets the customer ask about other options.
FAQ
Q: Do I have to create additional variants if I only sell one presentation? A: No. The default variant is enough for most products.
Q: Can I have variants with different currencies? A: Yes — each variant defines its own currency. Useful if you sell the same product in different regions.
Q: How many variants can I have per product? A: There's no hard practical limit, but we recommend no more than a few dozen so the customer's choice stays clear.
Q: Can the AI agent filter by variant? A: Search and filtering operate at the product level; once it finds the product, the agent can list available variants and guide the customer to the right one.