Is this really the version you are looking for? Kentico 8 documentation is no longer updated. Use the switch in the header to choose your Kentico version.

Working with product options

Product options offer your customers greater variability in choosing the right product. The system allows you to organize the options by dividing them into categories of the following types:

  • Attribute (e.g. Color of clothing)
  • Products (e.g. Portable PC accessories, Configurable PC - Operating system)
  • Text (e.g. Book - Inscription)

You can then offer and sell product options together with selected products and services.

For example, your on-line store sells books (products) and your customers can optionally buy the books with inscriptions (product options). Or perhaps your store sells T-shirts and allows your customers to buy the T-shirts (products) in multiple colors (product options).

Another use of product options consists in offering them as special additions to the products. For example, your store sells portable computers (main products), and your customers can optionally order the computers with portable printers (product options).

Besides, you can offer product options as components of products they constitute. For example, hardware components (product options) of a configurable computer system (main product).

You can also offer combinations of product options from multiple product option categories as variants of the main product. For example, the T-shirts (main products) that you offer in your on-line store are available in different sizes and colors (product options from two different product option categories). Each combination of size and color for a given T-shirt (product variant) behaves in the system as a separate product. This means that each variant has its own product number, price and stock records.

Currently, the system doesn't support volume discounts for product options.

You can manage product options in the Kentico E-commerce Solution administration interface, as described below.

You can also manage product options for selected products in the Pages application while editing the corresponding product documents on the SKU -> Options tab.

Creating product options

Each product option in the Kentico E-commerce Solution belongs to a product option category. To be able to use product options, you first need to create product option categories.

On this page

In this section

Creating product option categories

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

  1. Click New product option category.
  2. Enter category properties in the General section.
                                 
    Based on your selection of the type of the category, the system displays more properties in the Options section.
    • 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
      
  3. Click Save.
    • The system displays the Options section.
  4. Enter category properties in the Options section.
                
    • Options section available for the Attribute and Products type option categories:
                
      Editing properties available for the Attribute and Products type option categories
                           
    • Options section available for the Text type option category:
                                   
      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.

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 through Step 4 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

You can add product options only to product option categories of the Attribute and Products types.

This is because 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. Enter option properties.

    • Adding a product option to a category of the Attribute type:
                
      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
                                                              
  5. Click Save.
    • (Optional) Click Save and create another (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, modify options' properties, etc.

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 in this section).
  5. Click Save and close the dialog.
    • (Optional) Click Save and create another (if you want to create more than one option).

Adding product options to products

In Kentico, 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 for the products only selected options from the assigned categories (applies to Attribute and Products categories only). 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.
    • The system opens the Select products dialog.
  4. Select the required products.
                 
    Selecting products

                                                      
  5.  Click Select.

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

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.
    • The system opens the Select products dialog.
  4. Select the required products.
  5. Click Select.

The system adds to the selected products the current product option category including all product options contained in the category.

Adding multiple product option categories to the currently edited product

  1. Click Add categories.
    • The system opens the Select product option categories dialog.
  2. Select the required categories.
  3. Click Select.

The system adds to the currently edited product the selected product option categories including all product options contained in the categories.

Adding a new product option category to the currently edited product

  1. Click New category.
  2. Enter category properties.
  3. Click Save and close the dialog.

The system assigns to the currently edited product the new option category (empty). Now you need to add 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
                                                     
    • (Optional) If the system doesn't offer any product option category for the product, you can add some by clicking Add categories.
    • (Optional) If the system doesn't offer any product option category for the product, you can add a new category by clicking New category.
                                                                                        
  4.  Select the options as required.
    • Allow all options - the system offers to the users for the product all options from the current category.
    • Allow only selected options - the system offers to the users for the product only selected options from the current category.
  5. Click Save & Close.

The system now offers to the users for the product only specified product options.

Applying taxes to product options

The Kentico E-commerce Solution allows you to specify which taxes should apply to product options belonging to product option categories of the Products type.

Product options from other category types (Attribute, 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. Select a product option category of the Products type and click Edit ().
  2. Switch to the Options tab.
  3. Select a product option and click Edit ().
  4. Switch to the Tax classes tab.
  5. Click Add tax classes.
    • The system opens the Select tax class dialog.
  6. Select the required tax classes.
        
    Selecting tax classes
                       
  7. Click Select.

The system adds the tax(es) to the product option. When your customers purchase products with this option, the system applies to the option the selected tax(es).

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. Select a product option category of the Products type and click Edit ().
  2. Switch to the Options tab.
  3. Select a product option and click Edit ().
  4. Switch to the Tax classes tab.
  5. Click Add tax classes.
    • The system opens the Select tax class dialog.
  6. Select the required tax classes.
  7. Click Select.

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 ().
  2. Switch to the Options tab.
  3. Select a product option and click Edit ().
  4. Modify product option properties as required.
  5. Click Save.

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

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

Removing product options

You can remove product options from your on-line store in the Product options application.

You cannot remove product options from Text product option categories. This is because each category of this type contains just one option.

If you need to remove such options, remove the categories in which they are contained.

  1. Select the product option category that contains the options you want to remove and click Edit ().
    • (Optional) Delete () the category. The system removes all options contained in the category at once.

      You cannot remove product option categories:

      • if the system uses the contained options in at least one order.
      • if the system uses the contained options in at least one product variant.
  2. Switch to the Options tab.
  3. Select a product option and click Delete ().

    You cannot remove product options:

    • if the system uses the options in at least one order.
    • if the system uses the options in at least one product variant.
    • (Optional) Repeat this step if you want to remove more options from the category.

The system removes the product option(s) from your on-line store.

You can also remove product options from your on-line store in the Products application while editing products on the Options -> Option categories tab.

Reference - Product option category properties

General
Option category name

The name of the product option category used internally, i.e. available in various parts of the system's administration interface.

The option category name allows your on-line store administrators to use a more descriptive name than the one displayed to the customers on the live site, e.g. Color of shoes.

Display name

The name of the product option category displayed to your on-line store customers on the live site.

The display name is supposed to be less descriptive than the option category name because the customers can see this name in the context of a given product, e.g. Color.

Code nameThe string identifier of the product option category object used by developers in the code. Unless there is a reason to set a particular value, you can leave the default (automatic) option, and the system generates an appropriate code name.
DescriptionTo make the product option category easier to use and maintain, you can add an explanation about the scenarios for which the category is intended, etc
EnabledIndicates if the product option category is enabled in the system. Product option categories that are not enabled cannot be assigned to any products.
Type

Here you can set the type of the product option category. The system offers the following types:

  • Attribute - the options available in categories of this type represent product attributes, e.g. product's different colors or sizes. This type of category allows the user to select only one option at a time.
  • Products - the options available in categories of this type represent separate products that your customers can optionally purchase together with the main product, e.g. PCs may be offered with printers as options. Options in this category can also represent components of a product, e.g. hardware components of a configurable PC. Based on the configuration of the product option category, this type of category allows the user to select a single option or multiple options at a time.
  • Text - the options available in categories of this type allow your customers to purchase products with optional texts. For example, you can offer books with inscriptions. Please note that there can be only one option in each such category.

Based on the selection of the type of the product option category, the system displays more properties in the Options section (Attribute, Products) or in the Configuration section (Text).

You cannot change the type of the product option category:

  • if the option(s) that it contains are used in the shopping cart,
  • if the option(s) that it contains are used in at least one order,
  • if the option(s) that it contains are used in at least one product variant.

                        

The following properties are available for the Attribute type and Products type option categories:

Options

User control type

Here you can specify the type of selector for options in this product option category. The system offers the following selection types:

  • Drop-down list
  • Radio buttons in both vertical and horizontal layout
  • Check boxes in both vertical and horizontal layout (available for Products type categories only)
Default text

Allows you to specify a prompt text, e.g. (Please select), displayed in the product option selector when your customers open a page offering the respective product options.

For example, your customers can order an operating system as an option for a configurable PC. When the customers open a page with the details of this product, the respective selector displays (Please select), while the system expects further customer input.

To ensure correct functionality, you must use the default record text as the value of the Predefined choice property.

Otherwise, the system may not display the prompt text as the product option selector's default value.

Predefined choice

Here you can specify which option(s) the system should select by default when the customer opens a page offering the respective product options. Only the Check box selection type allows you to pre-select more than one option.

If the Display price adjustment property is enabled, the system may display the options together with respective price adjustments (if defined), e.g. (+ $29.99). The + and - characters indicate if the adjustment represents an additional charge to or reduction of the price of the main product.

Display price adjustment

If enabled, the price as specified to be charged for product options in this category is displayed to the user.

For example, the price adjustment for a selected product option is displayed to your customers on the live site while viewing the details of a product. (The product must be offered together with the given product option.)

Specifying price adjustment for product options is optional.

This means that no price may be displayed for some product options even if this property is enabled.

                             

The following properties are available for the Text type option category:

Options

User control typeHere you can specify the type of input field that your customers use to enter the text. The system offers a simple text input field, and a multi-line text input field.
Predefined choice

Allows you to specify a prompt text, e.g. (Enter your text), displayed in the text input field when your customers open a page offering the respective product option.

For example, your customers can order an engraving as an option for a watch. When the customers open a page with the details of this product, the system displays (Enter your text) in the respective text input field, while waiting for further customer input.

If the Display price adjustment property is enabled, the option may be displayed together with the respective price adjustment (if defined), e.g. (+ $9.99). The + and - characters indicate if the adjustment represents an additional charge to or reduction of the price of the main product.

Display price adjustment

If enabled, the price as specified to be charged for a product option in this category is displayed to the user.

For example, the price adjustment for a given product option is displayed to your customers on the live site while viewing the details of a product. (The product must be offered together with this product option.)

Specifying price adjustment for product options is optional.

This means that no price may be displayed for some product options even if this property is enabled.

Validation
Minimum text lengthHere you can specify the minimum length of the text that your customers must enter.
Maximal text lengthHere you can specify the maximum length of the text that your customers can enter.

Reference - Product option properties

The system offers product options of the following types:


Attribute - such product options represent attributes of the main product. For example, its different colors, sizes etc.

Option nameThe name of the product option that is displayed to your customers on the live site and to the users in the administration interface.
Price adjustment

Here you can specify the price adjustment for the product option, e.g. + 9.99 USD. The + and - characters indicate if the adjustment represents an additional charge to or reduction of the price of the main product.

Unlike product price, attribute product option price can have a negative value. This is because this price is an amount that is either added to or subtracted from the price of the main product.

Allow for saleHere you can specify if the product option should be allowed for sale in your on-line store, i.e. whether your store administrators can offer it together with selected products.

                               

Products - such product options represent separate products. This means that for these options you can define product-related properties (SKU number, Manufacturer, etc.) and keep corresponding stock records.

The system offers Standard product, E-product and Membership product representations as product options. The Standard product properties are shared while E-products and Memberships have also their special properties.

  • Standard product - standard products typically represent product articles and services. The system offers the following properties for all product representations:

General

Product nameThe name of the product (product option) that is displayed to your customers on the live site and to the users in the administration interface.
SKU numberAllows you to specify the product number (serial number or SKU number). You can use this number, for example, in your accounting records.
Price

Allows you to specify the price adjustment for the product (product option) in your on-line store main currency, e.g. 9.99 USD.

Department

Here you can specify a department for the product (product option).

You can add a new department directly, without the need to navigate to the dedicated Departments section:

  1. Click New.
  2. Enter the department properties as required.
  3. Click Save & Close.

Now you can use the department for this product (product option), same as for any other product that you offer in your on-line store.

Manufacturer

Here you can specify the product (product option) manufacturer.

You can add a new manufacturer directly, without the need to navigate to the dedicated Manufacturers section:

  1. Click New.
  2. Enter the manufacturer properties as required.
  3. Click Save & Close.

Now you can use the manufacturer for this product (product option), same as for any other product that you offer in your on-line store.

Supplier

You can use the field to enter the supplier of the product (product option).

You can add a new supplier directly, without the need to navigate to the dedicated Suppliers section:

  1. Click New.
  2. Enter the supplier properties as required.
  3. Click Save & Close.

Now you can use the supplier for this product (product option), same as for any other product that you offer in your on-line store.

Representing

Allows you to specify a representation of the product (product option). You can choose from three different representations:

The system offers as product options a standard product representation, i.e. Standard product, and two specialized types derived from this general type, i.e. Membership and E-product.

Custom properties

In this section you can edit product's (product option's) custom properties that you added in Modules -> Edit () E-commerce -> Classes -> Edit () SKU -> Fields.

If there is no such custom property defined in the system, the section is unavailable.

Status

Allow for saleIndicates if the product (product option) is allowed for sale in your on-line store, i.e. whether your store administrators can offer it together with selected products.

Shipping

Needs shipping

Indicates if the product (product option) requires shipping from your on-line store warehouse to an address specified by the customer.

Memberships and e-products don't require shipping.

Package weightAllows you to specify package weight in units of your choice.
Package heightAllows you to specify package height in units of your choice.
Package widthAllows you to specify package width in units of your choice.
Package depthAllows you to specify package depth in units of your choice.

Inventory

Track inventory

Allows you to determine whether the system should track product (product option) inventory.

If allowed, the system can offer the users inventory-related information such as the number of available product (product option) items or quantity at which the product (product option) needs to be reordered. You can also specify whether your customers can purchase the product (product option) only if it is available in stock.

Sell only if items availableIndicates if your customers can purchase only quantity of the product (product option) that is in stock (checked box). If you wish to use this property, the Track inventory property must be enabled.
Available itemsIndicates the number of product (product option) items available in stock. If you wish to use this property, the Track inventory property must be enabled.
Reorder at

Indicates at which quantity you/your on-line store administrators should reorder the product (product option).

Available only if the Track inventory property is enabled.

The system informs you about products (product options) that you should reorder in the Inventory report (in Store reports -> Products -> Inventory). You can also configure the Products widget (in Store overview) to display this information.

Min items in one orderHere you can specify the minimum number of product (product option) items in one order.
Max items in one orderHere you can specify the maximum number of product (product option) items in one order.

Analytics

The section is not available if you are adding a new global product (product option).

Conversion name

Allows you to select a conversion logged when a customer purchases, i.e. orders, the product (product option).

  • Click Select to select a conversion from a list of conversion objects available for the current site.
  • Click Edit to edit the currently selected conversion.
  • Click New to create a new conversion or replace the currently selected one.
Conversion value

Here you can enter a numerical value that the system records for the specified conversion on purchasing the product (product option). The values are cumulative, i.e. when a conversion hit is logged, the specified value is added to the total sum previously recorded for the given conversion.

You may insert a macro expression into this field to dynamically retrieve a value from the current site context. For example: {%ShoppingCartItem.UnitTotalPrice%}.

This sample macro allows the conversion to log the price of the given product as its value. The advantage of a macro is that it retrieves the price dynamically, including tax and any potential discounts applied by the given customer.

Membership - such product options are sets of roles. You can use memberships to allow the customers access to paid premium content and other restricted website sections, or to allow them to perform actions that are not available for ordinary website users.

Membership

Membership group

Membership defined in the Membership application. Your customers get this membership if they purchase the product (product option).

Membership validity

Indicates how long the membership is valid after the purchase.

You can set the validity either for a limited period (Days, Weeks, Months, Years, Until a given date) or for an unlimited period. To set membership validity for an unlimited period of time, choose Until and leave the text box below empty.

  • E-product - e-products are electronic files that your customers can download after the purchase.

E-product

Files validity

Indicates how long your customers can download the file(s) after the purchase.

You can set the validity either for a limited period (Days, Weeks, Months, Years, Until a given date) or for an unlimited period. To set e-product validity for an unlimited period of time, choose Until and leave the text box below empty.

Files

Here you can upload file(s) that will make up the e-product.

After uploading a file (by clicking New attachment and opening the required file), the system displays the name and size of the file, and allows you to perform the following actions:

  • Edit () - if the file is an image, clicking the icon opens the image in the built-in Image editor; see Editing images. If the file is not an image, clicking the icon opens the file in the built-in Metadata editor; see Editing file metadata.
  • Delete () - removes the attached file from the e-product.
  • Other actions (...) - allows you to Clone the attached file.
  • Update () - allows you to replace the attached file with a different file.
                  

You can upload only files with allowed extensions, as defined in the Upload extensions property in Settings -> System -> Files -> Security.

                      

Text - such product options represent inscriptions, labels, etc. For example, inscriptions in books, labels on cell phone covers, etc.

Option nameThe name of the product option that is displayed to your customers on the live site and to the users in the administration interface.
Price adjustment

Here you can specify the price adjustment for the product option, e.g. + 9.99 USD. The + and - characters indicate if the adjustment represents an additional charge to or reduction of the price of the main product.

Unlike product price, text product option price can have a negative value. This is because this price is an amount that is either added to or subtracted from the price of the main product.