---
title: Creating and modifying product options
---

> 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).

## Creating product options

Each product option in Xperience belongs to a product option category. To be able to use product options, you first need to create product option categories.

### Creating product option categories

You can create product option categories in the **Product options** application.

1. Click **New product option category**.
2. &#x20;Enter category properties in the [General](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-category-properties.md) category.\
   Based on your selection of the type of the category, the system displays more properties in the **Options** category.

   - **Attribute** – the options represent product attributes, e.g., product's different colors or sizes.
   - **Products** – the options represent separate products that your customers can optionally purchase together with the main product, e.g. you can offer PCs with printers as options. Options in this category can also represent components of a product, e.g. hardware components of a configurable PC.
   - **Text** – the options allow your customers to purchase products with optional texts. For example, you can offer books with inscriptions.

   ![Available product option types](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/available_product_option_types.png "Available product option types")
3. Click **Save**.
   - The system displays the **Options** category.
4. &#x20;Enter category properties in the [Options](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-category-properties.md) category.

   - **Options category** available for the **Attribute** and **Products** type option categories:

     ![Editing properties available for the Attribute and Products type option categories](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/properties_for_attributes_and_products.png "Editing properties available for the Attribute and Products type option categories")
   - **Options category** available for the **Text** type option category:

     ![Editing properties available for the Text type option category](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/properties_for_text.png "Editing properties available for the Text type option category")
5. Click **Save**.

The system creates an empty product option category of the selected type. You can now add product options to the category.

> **Info:**&#x20;
>
> #### Creating product option categories while editing products
>
> You can also create product option categories in the **Products** application while editing products on the **Options -> Option categories** tab.
>
> 1. Click **New category**.
> 2. Enter category properties (see [Step 2](#creatingandmodifyingproductoptions-a0) through [Step 4](#creatingandmodifyingproductoptions-a1) in this section).
> 3. Click **Save** and close the dialog.
>
> If you create a product option category this way, the category is automatically assigned to the respective product.

### Adding product options to product option categories

> **Note:** You can add product options only to product option categories of the **Attribute** and **Products** types.
>
> Categories of the **Text** type contain only one option, which the system adds automatically.

You can add new product options to existing product option categories in the **Product options** application.

1. Select a product option category and click **Edit** ().
2. Switch to the **Options** tab.
3. Perform the corresponding action:

   - Click **New option** if you are adding a new option to a category of the **Attribute** type.
   - Click **New product** if you are adding a new option to a category of the **Products** type.
4. &#x20;Enter [option properties](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-properties.md).

   - Adding a product option to a category of the **Attribute** type:

     ![Adding a product option to a category of the Attribute type](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/adding_properties_attribute.png "Adding a product option to a category of the Attribute type")
   - Adding a product option to a category of the **Products** type:

     ![Adding a product option to a category of the Products type](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/adding_properties_product.png "Adding a product option to a category of the Products type")
5. Click **Save**
   - (Optional) Click **Save and create another** instead if you want to create more than one option.

The system adds product options to the given category. You can now use the options in your on-line store. For example, you can [add the options to selected products](#adding-product-options-to-products), [modify options' properties](#modifying-product-options), etc.

> **Info:** **Adding product options to product option categories while editing products**
>
> You can also add product options to product option categories in the **Products** application while editing products on the **Options -> Option categories** tab.
>
> 1. Select a product option category and click **Edit category properties**().
> 2. Switch to the **Options** tab .
> 3. Perform the corresponding action, i.e., **New option** or **New product**.
> 4. Enter option properties (see [Step 4](#creatingandmodifyingproductoptions-a2) in this section).
> 5. Click **Save** and close the dialog.
>
>    - (Optional) Click **Save and create another** instead if you want to create more than one option.

## Adding product options to products

In Xperience, you cannot add product options to your products directly. If you want to use options for your products, you must add to each product at least one (non-empty) option category. Later you can specify that the system should use only selected options from the assigned categories (applies to _Attribute_ and _Products_ [categories](#creatingandmodifyingproductoptions-a0) only) for the products. Otherwise, the system uses all options from these categories.

### Adding product option categories to products

You can add product option categories to products in the **Product options** application.

1. Select a product option category and click **Edit** ().
2. Switch to the **Products** tab.
3. Click **Add products** to open the **Select products** dialog.
4. Select the required products.

   ![Selecting products](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/selecting_products.png "Selecting products")
5. Click **Select**.

The system adds the current product option category to the selected products including **all product options contained in the category**. You can now specify which options from this category the system should use for the products.

> **Info:**&#x20;
>
> #### Adding product option categories to products while editing products
>
> You can also add product option categories to products in the **Products** application while editing products on the **Options -> Option categories** tab.
>
> **Adding product option categories to multiple products at once (while editing a product)**
>
> 1. Select a product option category and click **Edit category properties** ().
> 2. Switch to the **Products** tab.
> 3. Click **Add products** to open the **Select products** dialog.
> 4. Select the required products.
> 5. Click **Select**.
>
> The system adds the current product option category to the selected products including all product options contained in the category.
>
> **&#x20; Adding multiple product option categories to the currently edited product**
>
> 1. Click **Add categories** to open the **Select product option categories** dialog.
> 2. Select the required categories.
> 3. Click **Select**.
>
> The system adds the selected product option categories to the currently edited product including all product options contained in the categories.
>
> **&#x20; Adding a new product option category to the currently edited product**
>
> 1. Click **New category**.
> 2. Enter [category properties](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-category-properties.md).
> 3. Click **Save** and close the dialog.
>
> The system assigns the new option category (empty) to the currently edited product. Now you need to [add](#adding-product-options-to-product-option-categories) some options to this category.

### Selecting available options for products

You can specify available options for products while editing the products in the **Products** application.

1. Select a product and click **Edit** ().
2. Switch to the **Options -> Option categories** tab.
3. Select a product option category (if available) and click **Select available options** ().

   - The system opens a dialog where you can specify available options for the product.

     ![Selecting available options](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/selecting_available_options.png "Selecting available options")
   - (Optional) If the system doesn't offer any product option category for the product, you can [add](#creatingandmodifyingproductoptions-a15) some by clicking **Add categories**.
   - (Optional) If the system doesn't offer any product option category for the product, you can [add](#creatingandmodifyingproductoptions-a16) a new category by clicking **New category**.
4. Select the options as required.

   - **Allow all options** – the system offers all product's options from the current category to the users.
   - **Allow only selected options** – the system offers only selected products' options from the current category to the users.

> **Tip:** It is recommended to select **Allow only selected options** and select some or all options. If you do so, you can then add more options to the option category and it will not have any effect on already created products and their options (the products will be offered with their specified options).
>
> However, if you select **Allow all options**, any new option added to the option category will be also offered for the already created products.

5. Click **Save & Close**.

The system now offers only those product options which were specified for the product.

## Applying taxes to product options

Xperience allows you to specify which [taxes](https://docs.kentico.com/13/e-commerce-features/configuring-on-line-stores/configuring-taxes.md) should apply to product options that belong to product option categories of the **Products** type.

> **Note:** Product options from other category types (**Attribute** and **Text**) use tax classes assigned to the main products.
>
> This means the options use tax classes assigned to the products with which you offer them.

You can add taxes to product options in the **Product options** application.

1. **Edit** () a product option category of the **Products** type.
2. Switch to the **Options** tab.
3. **Edit** () a product option.
4. Select the desired tax class in the **Tax class** field.

   ![Selecting tax classes](https://docs.kentico.com/docsassets/13/creating-and-modifying-product-options/selecting_tax_classes.png "Selecting tax classes")
5. Click **Save**.

The system adds the taxes to the product option. When your customers purchase products with this option, the system applies the selected taxes to the option.

> **Info:**&#x20;
>
> #### Applying taxes to product options while editing products
>
> You can also apply taxes to product options in the **Products** application while editing products on the **Options -> Option categories** tab.
>
> 1. **Edit** () a product option category of the **Products** type.
> 2. Switch to the **Options** tab.
> 3. **Edit** () a product option.
> 4. Select the desired tax class in the **Tax class** field.
> 5. Click **Save**.

## Modifying product options

You can modify product options in the **Product options** application.

1. Select the product option category that contains the option you want to modify and click **Edit** ().

   - The system opens the category's **General** tab where you can modify [option category properties](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-category-properties.md).
2. Switch to the **Options** tab.
3. Select a product option and click **Edit** ().
4. Modify [product option properties](https://docs.kentico.com/13/e-commerce-features/managing-on-line-stores/products/working-with-product-options/creating-and-modifying-product-options/reference-product-option-properties.md) as required.
5. Click **Save**.

You can now use the product option (product option category) with its updated settings.

> **Info:** You can also modify product options in the **Products** application while editing products on the **Options -> Option categories** tab.
