---
title: Example - Adding a product with a Text option
related:
  - https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/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).

The example demonstrates how you can add a product with a _[Text](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products/working-with-product-options.md)_ option to a Kentico site. The product is based on the _Product - Book_ product type, and has one product option.

The example uses the sample _E-commerce Site_.

## Adding a new product

First, you need to add a new product of the required [type](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products/managing-product-types-and-product-section-types.md) and [representation](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products/managing-product-representations.md) to a selected part of your on-line store.

1. Open the **Products** application.
2. Select **Books -> Technical** in the product sections tree and click **New** ().         

   - The system opens a dialog allowing you to specify the required type of your new product.
3. Select **Product - Book** in the **Product types** column.

   ![Selecting a product type](https://docs.kentico.com/docsassets/k81/example-adding-a-product-with-a-text-option/selecting_product_type.png "Selecting a product type")

   - The system opens a page where you can specify product properties.
   - Alternatively, you can select some other product type, e.g. **Product**.
   - If the system doesn't offer any product type (for example, if you deleted the default product types), create a new product type as described in [Managing product types and product section types](https://docs.kentico.com/k81/e-commerce-features/configuring-and-managing-your-store/products/managing-product-types-and-product-section-types.md).
4. Enter the following values for the product's properties:

   - **Product name**: Developing Websites with Kentico
   - **Price**: 19.99
   - **Department**: Books
   - **Image**: upload an image file
   - **Representing**: Standard product
   - **Allow for sale**: Yes (checked)
   - **Available items**: 10
5. Click **Save**.

The system adds the product to the selected part of your on-line store. Now you can add to the product a product option category.

## Adding a product option category to the product

1. Switch to the product's **Options -> Option categories** tab and click **New category**.               

   - Alternatively, you can add to the product an existing category by clicking **Add categories**.
2. Enter the following values for the category's properties:

   - **Option category name**: Book inscription

     > **Info:** The system uses this name in your on-line store administration interface.
   - **Display name**: Inscription

     > **Info:** The system uses this name on the live site.
   - **Enabled**: Yes (checked)
   - **Type**: Text
3. Click **Save**.
4. Enter the following values for the category's properties in the **Options** and **Validation** sections:

   - **User control type**: Text field
   - **Display price adjustment**: Yes (checked)
   - **Maximal text length**: 50
5. Click **Save** and close the dialog.

If you now switch back to the product's **Options -> Option categories** tab, the system lists the product option category as assigned to the product. As an option category of type _Text_, the category automatically contains one option, which you can now modify.

![Available option categories](https://docs.kentico.com/docsassets/k81/example-adding-a-product-with-a-text-option/available_option_categories.png "Available option categories")

## Configuring the product option

1. **Edit** () the _**Book inscription**_ product option category and switch to its **Options** tab.

   ![Viewing the list of available options](https://docs.kentico.com/docsassets/k81/example-adding-a-product-with-a-text-option/viewing_list_of_available_options.png "Viewing the list of available options")
2. Enter the following value for the option's **Price adjustment** property: _5_.
3. Click ****.

If your customers purchase the product together with the product option, they will have to pay an extra charge.

## Reviewing the product on the live site

1. Open the live site.
2. Select **Books -> Technical** in your on-line store main menu.

   - The system displays a list of all technical books that you offer in your on-line store.
3. Click **Developing Websites with Kentico** to view the product's details page.
4. Enter _**My inscription**_ into the **Inscription** field.

   ![Viewing the product details page](https://docs.kentico.com/docsassets/k81/example-adding-a-product-with-a-text-option/viewing_product_details_page.png "Viewing the product details page")
5. Click **Add to cart**.

The system adds the product together with the product option to the shopping cart.

![Viewing the shopping cart content](https://docs.kentico.com/docsassets/k81/example-adding-a-product-with-a-text-option/viewing_shopping_cart_content.png "Viewing the shopping cart content")