Configure product variants
Product variants allow you to create color and size variations of a single product. Each variant becomes a child product linked to the parent, with its own pricing, barcodes, and stock tracking.
Note: For a conceptual overview of how variants work, see Products overview.
On this page
- Before you begin
- Enable colors and sizes for products
- Define colours
- Define sizes
- Assign variants to a product
- Manage existing variants
- How variants appear in the Appointment Book and POS
- What to configure next
- Tips
- Troubleshooting
- Related articles
Before you begin
Permission: Add and Edit (both required under Products) — Required to access variant management.
- The Enable colors and sizes for products organization setting must be on. Navigate to Configuration > Products to turn it on.
- Colors and sizes must be defined before they can be assigned to products.
- The product you want to add variants to must already exist. To create one, see Create and manage products.
- Product colors and Product sizes are organization-only rows. At center scope the Configuration > Products page shows only Brands, Product categories, Vendors, Product tags, and Product tag groups, so set the scope selector to your organization before you start.
Steps
Enable colors and sizes for products
- Navigate to Configuration > Products with the scope selector set to your organization.
- Turn on Enable colors and sizes for products.
- Optionally, set Product color label to the name you want to use for the colour attribute throughout your catalog (for example, "Shade" or "Finish"). This value is used as the field and column heading on the Product colors page, so setting it to something meaningful makes that page easier to read.
- Click Save.
Note: This setting applies to the entire organization. The Product colors and Product sizes rows are hidden when it is off.
Important: Enable colors and sizes for products is a different setting from Variants under Master Creation > Custom details, which controls whether the variants field appears on the product creation form. Turning on one does not turn on the other. Turn on Enable colors and sizes for products to get the Product colors and Product sizes rows.
Define colours
- Navigate to Configuration > Products > Product colors.
- In Add New (followed by whatever you set as Product color label), enter the colour in the Name field.
- Select Active to make the colour available for use.
- Click Add.
Repeat for each colour you need. To find an existing colour, use the search box and click Search. To remove one, click the red × on its row and confirm Yes in the Delete Item dialog.
Define sizes
- Navigate to Configuration > Products > Product sizes.
- Enter the size in the Size Name field.
- Select Active to make the size available for use.
- Click Add.
Repeat for each size you need. To find an existing size, enter it in the search box and click Search.
Assign variants to a product
- Navigate to Inventory > Products.
- Open the product you want to add variants to.
- Navigate to the VARIANTS tab (this tab only appears when Enable colors and sizes for products is on).
- Add a variant.
- Select a Color and/or Size combination.
- The system creates a child product linked to the parent with the Variant flag enabled.
- Configure the variant's pricing, barcodes, and center associations as needed.
- Click Save.
Worked example: A salon sells "Luxe Hydrating Shampoo" in two bottle sizes and two formulations. Under Configuration > Products > Product colors the admin adds Classic and Repair; under Product sizes the admin adds 250 ml and 1 L. On the shampoo's VARIANTS tab the admin adds four variants — Classic/250 ml, Classic/1 L, Repair/250 ml, Repair/1 L — giving each its own product code (
LUX-CL-250,LUX-CL-1L,LUX-RP-250,LUX-RP-1L), its own barcode, and its own sale price at each center ($24 for the 250 ml variants, $58 for the 1 L variants). Stock is then counted and sold against each of the four child products separately, while "Luxe Hydrating Shampoo" remains the parent that groups them.
Manage existing variants
- To edit a variant, open the parent product, navigate to the VARIANTS tab, and click the variant to edit.
- Variants are child products — they can be found in the product listing when filtering by the parent product or by variant attributes.
How variants appear in the Appointment Book and POS
Whether staff see the parent product or its individual variants is controlled by the organization setting Show product and service variants in appointment book and POS, at Configuration > Appointments > Personalization > Interface. It is on by default.
- While it is on (the default) — POS product search and the Appointment Book price check list each variant as its own item, and the parent product does not appear there under its own name. Searching for "Luxe Hydrating Shampoo" alone will not return the parent; search for the variant instead.
- While it is off — the parent product is listed instead of its variants.
The product record itself is unaffected either way: the parent product, its variants, and their codes, prices, and stock all remain exactly as configured. Only what staff see in the Appointment Book and POS changes. To change this setting, see Configure appointment essentials.
What to configure next
After you create variants, complete these steps:
Required
- Set a sale price and tax group for each variant at every center that sells it. See Configure product pricing.
- Associate each variant with the centers that stock it. See Assign products to centers.
Optional
- Add a barcode to each variant so staff can scan it at the point of sale. See Product Barcodes & Codes.
- Associate each variant with its vendors and set purchase prices. See Manage vendor associations.
- Set commission for each variant. See Configure product commission.
- Make variants visible in your Webstore. See Configure products for Webstore.
Tips
- Define all color and size options at the organization level before assigning them to products — you cannot create new color or size options directly from the variant assignment screen.
- Variants inherit the parent product's category, brand, and other catalog properties, but each variant has its own pricing and barcodes.
- Give each variant a product code that reflects its colour and size (for example,
LUX-CL-250) so staff can identify it in reports and on purchase orders without opening the parent product. - Keep the colour and size lists short and consistent across your catalog. Every combination you create becomes a separate product that needs its own price, barcode, and stock count at each center.
- Deselect Active on a colour or size you no longer offer instead of deleting it. Deleting removes the option entirely, while deactivating keeps existing variants intact and stops the option appearing on new ones.
Troubleshooting
- The VARIANTS tab does not appear on the product. The Enable colors and sizes for products organization setting is off, or your role is missing one of the two required permissions. Confirm the setting at Configuration > Products at organization scope, then confirm your role has both Add and Edit under Products. Both permissions are required — having only one hides variant management.
- The Product colors and Product sizes rows are missing from Configuration > Products. Either the scope selector is set to a center, or Enable colors and sizes for products is off. Both rows are organization-only: at center scope the page shows only Brands, Product categories, Vendors, Product tags, and Product tag groups. Switch the scope selector to your organization.
- You turned on Variants under Master Creation > Custom details but the Product colors and Product sizes rows are still hidden. These are two separate settings. Turn on Enable colors and sizes for products on the Configuration > Products page — the Variants custom-details option only controls whether the variants field appears on the product creation form.
- Staff cannot find the parent product when searching in the POS. This is expected while Show product and service variants in appointment book and POS is on, which is the default — POS product search and the Appointment Book price check list each variant as its own item and do not list the parent. Have staff search for the specific variant, or turn the setting off at Configuration > Appointments > Personalization > Interface to list the parent instead.
- A colour or size you added does not appear when you assign variants. The option was saved without Active selected. Return to Configuration > Products > Product colors or Configuration > Products > Product sizes, locate the option, and set it to active.
- A variant shows no price at a center. Each variant is a separate product and needs its own center association and sale price. Open the variant, go to the PRICE tab, associate it with the center, and set the sale price and tax group. See Configure product pricing.
- Bulk assignment of colours or sizes fails for some products. The bulk API validates every colour and size against the organization's defined options and rejects values that do not match an active option, or any colour or size at all when Enable colors and sizes for products is off. Confirm the setting is on and that the values in your file exactly match the colour and size names defined in Zenoti.