Creating product options

Edit on GitHub

This article describes how to create a product option.

Prerequisites

To start working with the product options, go to Products > Product Options.

You should have an appropriate Tax Set created in the Taxes section in order to apply it to the product option group.

Let’s say you want to add additional options to your product, like a warranty or a gift box. Those are exactly the things that are created in the Product Options section. Such options will have their own prices, and the user will be able to select the most suitable one.

Each section contains reference information. Make sure to review it before you start, or just look up the necessary information as you go through the process.

Creating a product option

To create a product option:

  1. On the Product option list page, in the top right corner, click Create product option.

  2. On the Create new Product Options page that opens, you see General Information and Products tabs. In the General Information tab:

    1. Add the group name translation key. The format of the group name translation key should be as follows: product.option.group.name.[your key]. For example, product.option.group.name.test.
    2. Define a tax set assigned to your product option group by selecting the appropriate value from the drop-down list.
    3. In the Option Values section, enter an option name translation key value. The format of the option name translation key should be as follows: product.option.[your key] (for example, product.option.newtest).
    Note

    You can remove an option value by clicking Remove next to the Option name translation key and SKU fields.

    1. Add a unique SKU for a product option value or proceed with the auto-generated one.
    2. In the Prices section, specify gross and net prices for a product option value. If you want to add several product options values, click Add option below the Prices section, and repeat the same step. Prices are integer values and stored in their normalized form. For example, 4EUR is stored as 400 in the database. When a price is not defined, the product option value is considered inactive for that specific currency and price mode. When a price is set to 0, it is considered free of charge.
    3. In the Translation section, add a group name and option name that will be displayed in the shop application per each locale. You can copy the Group and Option names from one locale to another using the corresponding Copy icon.
  3. Click Next to proceed to the Products tab, or just click on it.

  4. In the Products tab, select product(s) to be assigned to the product. Alternatively, you can click Select all on the page. In this case, all the products displayed on the page will be selected and added to the product option. The products you select will appear in the Products to be assigned tab.

  5. Click Save.

Reference information: Creating a product option

The following table describes the attributes you enter and select while creating or updating product options.

ATTRIBUTE DESCRIPTION
Group name translation key Glossary key for a product option group. The format of the group name translation key should be as follows: product.option.group.name.[your key]. For example, product.option.group.name.test.

This field is not available for modification on the Edit Product Option page.
Tax Set Conditions under which a specific product option group is going to be taxed. A drop-down list with the values from Taxes > Tax Sets.
Option name translation key Glossary key for a product option value. The format of the option name translation key should be as follows: product.option.[your key]. For example, product.option.newtest.

This field is not available for modification on the Edit Product Option page.
SKU Unique SKU for a product option value. This value can be autogenerated, and you can use the autogenerated one.
This field is not available for modification on the Edit Product Option page.
Gross price and Net price Price value for gross and net mode.
Group name Name of your option group.
Option name Name of your option.

Tips & tricks
While creating a product option, if you want to remove some product from the selected, clear check boxes next to the products you selected or click Deselect all on the page (this will remove all products from the to-be-assigned list you selected on this page).

You can switch between All products and Products to be assigned view by selecting the respective options on the top of the products table. image

If you know the name or the SKU of the product to which an option should be assigned, you can search for it in the Search field.

Each product abstract can have multiple product option groups assigned.

Activating a product option

Your product option is created; however, it is not activated. Thus, it will not be seen on the product details page.

To activate a product option:

On the Edit product option page, click Activate in the top right corner. OR On the Product option list page, click Activate for a specific product option in the Actions column.

Reference information: Activating a product option

This section describes attribtutes you see when activating a product option and provides an example of how a product option is displayed on the Storefront.

Product Option List page

On the Product option list page, you see the following information:

  • The autogenerated option group ID.
  • Group name and the SKU for it.
  • The name of the product option.
  • Gross and net price of the product option.
  • Status (either Active or Inactive).
  • Actions that you can perform for each specific option (Edit, View, Activate/Deactivate).

By default, the table is sorted by Option group ID. You can sort the table by the Group name and Status columns.

Product option examples on the Storefront

On the following example, the Warranty and Insurance are the product option groups:

Product option example

And the values available in the drop-down lists are the product options: Select an option

What’s next?
Once the option is created, you may want to know how those options are managed. See Managing product options for more details.