--- title: Working with product variants related: - https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products.md - https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options.md --- > Agent instructions: > **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown. > > - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version. > - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt). Product variants are combinations of product options from [product option](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options.md) categories of the _Attribute_ type. You can offer and manage the variants as separate products. For example, your on-line store sells T-shirts (products) that are available to your customers in different sizes and colors (combinations of options from two product option categories). Each combination of size and color for a given T-shirt (product variant) has its own SKU (product number), price and stock records. Each variant behaves in the system as a separate product. Or perhaps your store sells sunglasses (products) for women, men and children (a combination of options from a single product option category). Each type of sunglasses (product variant) has its own SKU, price and stock records. Again, each variant behaves in the system as a separate product. > **Tip:** You can manage product variants in the Xperience administration interface, as described below. > > You can also manage product variants for selected products in the **Pages** application while editing the corresponding product pages on the **SKU -> Variants** tab. ## Adding variants to products > **Info:** You can add variants only to products that use product options from at least one ENABLED product option category of the **Attribute** type. > > You can [add](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options.md) such product option categories to your products while editing the products on the **Options -> Option categories** tab. You can add variants to your products in the **Products** application while editing the products on the **Options -> Variants** tab. 1. Click **Define available variants**. 2. Select option categories. - The system allows you to add variants from selected categories only. 3. Select variants. - Your customers can purchase only selected variants from these categories. 4. Click **Save**. ![Defining available variants](https://docs.kentico.com/docsassets/13/working-with-product-variants/defining_available_variants.png "Defining available variants") Your customers can now purchase the currently edited product in multiple variants. > **Info:** **Minimum and maximum numbers of items in one order** > > Variants inherit the minimum and maximum numbers of items in one order from the variant's parent product. If customers buy multiple variants of the same product, quantity of each variant needs to be between the minimum and maximum allowed numbers of items. The quantity of variants is not counted together. > > You can set the minimum and maximum numbers of items in one order in the **Min items in one order** and **Max items in one order** fields when editing a product. ## Filtering variants The system allows you to view for the current product only variants matching certain search criteria (e.g. a combination of options, variant name, SKU). > **Info:** The system shows all product option categories whose options it uses in the variants (e.g. _Color_, _Size_). > > You can select any options from these categories (e.g. _Black_, _White_, _S_, _M_, _L_), as you specified while selecting [available options for products](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options.md). 1. Open the **Products** application. 2. **Edit** () a selected product. 3. Switch to the **Options -> Variants** tab. - The system shows all variants available for the current product. ![Viewing all available variants](https://docs.kentico.com/docsassets/13/working-with-product-variants/available_variants.png "Viewing all available variants") 4. Specify your search criteria. 5. Click **Search**. 6. (Optional) Click **Reset** to view all variants available for the current product. The system shows for the current product only variants matching your search criteria. ![Viewing only selected variants](https://docs.kentico.com/docsassets/13/working-with-product-variants/viewing_selected_variants.png "Viewing only selected variants") ## Changing the price of multiple variants at once Xperience allows you to change the price of multiple variants of the current product at once. For example, you want to charge the same price for all items of a specific T-shirt in a specific color. 1. Open the **Products** application. 2. **Edit** () a selected product. 3. Switch to the **Options -> Variants** tab. - The system displays all variants available for the current product (if any). 4. Select the variants whose price you want to change (check the respective boxes). 5. Choose **Selected variants** in the left drop-down list. 6. Select **Change price** in the right drop-down list. - The system displays the **New price** field. 7. Enter the new price for the selected variants. ![Changing the price of multiple variants at once](https://docs.kentico.com/docsassets/13/working-with-product-variants/changing_price_atonce.png "Changing the price of multiple variants at once") 8. Click **OK**. > **Info:** You can change the price of all available variants of the current product at once. > > To do so, select **All variants** in the left drop-down list (Step 5) while following the steps in this subsection. Your customers can now purchase the selected variants of the current product for the new price. ## Modifying variants You can modify product variants in the **Products** application while editing products on the **Options -> Variants** tab. 1. Select a variant and click **Edit** (). 2. Modify the [variant properties](#reference---variant-properties) as required. 3. Click **Save**. You can now use the variant with its updated settings. ## Removing variants You can remove product variants from your on-line store in the **Products** application while editing products on the **Options -> Variants** tab. > **Note:** You cannot remove variants which are used in at least one [order](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/orders.md). ### Removing variants one by one 1. Select a variant. 2. Click **Delete** (). 3. Confirm that you want to remove the variant (**OK**). The system removes the variant from your on-line store. ### Removing multiple variants at once 1. Select the variants you want to remove (check the respective boxes). 2. Choose **Selected variants** in the left drop-down list. 3. Select **Delete** in the right drop-down list. 4. Click **OK**. ![Removing multiple variants at once](https://docs.kentico.com/docsassets/13/working-with-product-variants/removing_variants_atonce.png "Removing multiple variants at once") > **Info:** You can remove all available variants from the current product at once. > > To do so, select **All variants** in the left drop-down list (Step 2) while following the steps in this subsection. The system removes the selected variants from your on-line store. ## Reference - Variant properties | General | | | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Variant name | The name of the variant that the system displays to your on-line store administrators in the administration interface. | | SKU | Allows you to specify a variant identifier, for example _L-Green_. You can use the identifier in your accounting records, etc. | | Price | Here you can specify the price of the variant in your store's [main currency](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-currencies.md).
Depending on the configuration of the site's **Prices include tax** [setting](https://docs.kentico.com/13/configuring-xperience/managing-sites/configuring-settings-for-sites/settings-e-commerce.md), enter the value with or without tax included. | | Allow for sale | Allows you to specify if your customers can purchase the variant. | | Collection | Allows you to assign the product variant to a collection. Collections can be defined in the dedicated **Collections** application (see [Managing product collections](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/managing-product-collections.md)).
If not assigned, the collection of the parent product is used.
Note: Collections are always related to a specific site, so they cannot be used for [global](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/choosing-site-or-global-e-commerce-configuration.md) products. | | Attributes | | | Indicates which attributes, i.e. options from option categories of the **Attribute** type, are used in the variant. For example _Color_ and _Size_. | | | Inventory**Info:** The system offers this section only if the product's **Track inventory** property (**General** tab) is set to _By variants_. | | | Available items | Here you can enter the number of variant items available in stock. | | Reorder at | Indicates at which quantity you or your store's administrators should reorder the variant.
The system informs you about variants that you should reorder in the _Inventory_ [report](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/store-reports.md) (in **Store reports -> Products -> Inventory**). You can also configure the **Products widget** (in **Store overview**) to display this information. | | Shipping | | | Package weight | Allows you to specify package weight in [units set for your on-line store](https://docs.kentico.com/13/configuring-xperience/managing-sites/configuring-settings-for-sites/settings-e-commerce.md). | | Package height | Allows you to specify package height in units of your choice. | | Package width | Allows you to specify package width in units of your choice. | | Package depth | Allows you to specify package depth in units of your choice. |