> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Option Attributes

Options include details about a product that shoppers can configure, such as size or color. You can use options in combination with Configurable Products with Options to generate new product variations (or unique SKU). Refer to [Product Variations](/pages/product-variations) for more information.

## Create Option Attributes

You must first create the option attribute before you can add it to product types, and assign option values to products.

To create an option attribute:

1. Go to **System** > **Schema** > **Product Attributes**.

2. Click **Create New Attribute**.

3. In the **Attribute Label** field, enter the name of the option that shoppers will see.

4. In the **Administration Name** field, enter the name that you will see in Admin.

5. In the **Attribute Code** field, enter a code for your option.

6. In the **Input Type** drop-down menu, select **List**.\
   List is the only input type that supports options.

   Once you create and save an attribute, you cannot change its input type.

7. In the **Attribute Type** field, select **Option**:<img src="https://mintcdn.com/kibocommerce-59e68a4a/HsxsmZiwYCuO9lws/img/option-attribute-configurations.png?fit=max&auto=format&n=HsxsmZiwYCuO9lws&q=85&s=0bdb1cd82361d8a515ca73de95b41703" alt="View of attribute configurations with a callout for the Option attribute type toggle" width="445" height="701" data-path="img/option-attribute-configurations.png" />

8. Select the **Data Type**, which determines whether the values that shoppers select are text or numbers.\
   For example, you're creating a color option, and you want the values to be text for the different colors.

9. In the **Values** section, add all possible values for the option. You select the option values that a product can have when you add the option to the product type. You then choose the specific option values that a product has when creating the product.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/HsxsmZiwYCuO9lws/img/option-attribute-values.png?fit=max&auto=format&n=HsxsmZiwYCuO9lws&q=85&s=06d950cd5b7a4ef9e7c5c17551df5e59" alt="The attribute values table with example labels and values" width="1396" height="434" data-path="img/option-attribute-values.png" />

   Press **Enter** after entering each value. You must add the associated value for every list entry, and you can reorder the values after adding them.

   You can use the order of the list values as the order of facet values on storefront pages by using the **Attribute Definition** facet value order. Refer to [Attribute Definition Options](/pages/facets#attribute-definition-options) in the Facet Value Order section of the Facets topic for more information about ordering the facet values according to the list values you specify on the attribute.

10. Select the **Search Options** for the option:
    * **Available to Storefront Search:** This determines whether the option's label or option's values are matched on when shoppers perform a search on the site. For example, you have a color option and one of its values is *blue*. If you select this checkbox and **Search Value**, and a shopper performs a search for the term "blue" on your site, the product will be returned in the search results even if the term "blue" is not contained in the product's name or description.
    * **Index Value with Case:** This determines whether the attribute value is case-sensitive for filtering and faceting. When enabled, the attribute will be capitalized consistently across facets and other uses. The default is not case-sensitive.
    * **Available as Filter and Sort:** This determines whether this option is available for filtering, sorting, dynamic category expressions, displayed on category pages, and as a facet in search results.

      Having a large number of attributes available for filtering and sorting can reduce the performance of your site. Kibo eCommerce recommends only enabling this checkbox for the attributes that are most likely to be used for these purposes.

11. If you have enabled [multiple locales for this catalog](/pages/multi-locale-catalogs "Multi-Locale Catalogs"), you can switch locales using the dropdown menu in the top right. This allows you to localize the attribute label and value labels for that language. The attribute name, code, and other settings (including adding new values) will not be displayed or editable, as those are only configurable on the default locale for the catalog.<img src="https://mintcdn.com/kibocommerce-59e68a4a/v_dzrGLoq2v4wGiy/img/catalog-locale-selector.png?fit=max&auto=format&n=v_dzrGLoq2v4wGiy&q=85&s=0e8c1d30b2e90db8a3c034418fa15b37" alt="The Switch Locale Code selector with example locales" width="433" height="492" data-path="img/catalog-locale-selector.png" />

12. Click **Save**.

## Add Options to Product Types

Once you create an option attribute, you can then add it to product types. This allows you to quickly select all applicable options for products belonging to the same product type.

For example, you created a color option, and you want its values to be applied to only shirts. You can add this color option to your shirt product type, so that any shirt products you create will have the same color option values from which you can select.

To add an option to a product type:

1. Go to **System** > **Schema** > **Product Types**.

2. Select the applicable product type.\
   If you need to create a new product type, refer to [Configure Product Types](/pages/configure-product-types) for more information.

3. In the **Options** section, click **Add**:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/5p2bvmH14ykLzZaY/img/add-options-to-product-types.png?fit=max&auto=format&n=5p2bvmH14ykLzZaY&q=85&s=3c315a2980f755eb352ee53b767f2852" alt="Close-up of the Options section with a callout for the Add button" width="622" height="158" data-path="img/add-options-to-product-types.png" />

4. In the **Attribute** list, select the applicable option:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/select-option-attribute.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=ce5523a4a36ca33cd98f20a496556b4f" alt="Close-up of the Attribute list with a callout for the example Color option" width="391" height="449" data-path="img/select-option-attribute.png" />

   Only attributes that you marked as an option when you created the attribute appear in this list.

5. In the **Values** list, select all applicable option values for the product type:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/HsxsmZiwYCuO9lws/img/option-values-list.png?fit=max&auto=format&n=HsxsmZiwYCuO9lws&q=85&s=6debe527ed284dc353f6a02c06323ffe" alt="Close-up of the Values list" width="259" height="461" data-path="img/option-values-list.png" />

   The selected values appear in the Selections list.

6. Decide whether the option is **Required by admin**.\
   If you select this checkbox, when you create a new product and assign it to the product type, you must assign at least one selected option value to the product in order for Kibo eCommerce to consider the product valid for the product type.

7. Click **Done** to finish adding the option to the product type:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/select-options-for-product-types.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=1b6aef36b51bdc5f7fa08da426b17311" alt="The Options configuration module with a callout for the Done button" width="1778" height="346" data-path="img/select-options-for-product-types.png" />

## Assign Option Values to Products

Once you add an option to a product type and selected all applicable option values for the product type, you can then assign the option's values to a product.

For example, you added a color option and selected all applicable color values for the shirt product type. Then when you create a new shirt product, you can assign the applicable color values to that specific shirt product. When you assign option values to a product, you create a product variant for each assigned option value. Refer to [Product Variations](/pages/product-variations) for more information.

To assign an option value to a product:

1. Go to **Main** > **Catalog** > **Products**.

2. Select the applicable product. If you need to create a new product, refer to [Configure Products](/pages/configure-products) for more information.

3. (**If applicable**) If you haven't already done so, assign the applicable **Product Type** to the product:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/yPPx2ALUR4FHFmVl/img/product-general-settings.png?fit=max&auto=format&n=yPPx2ALUR4FHFmVl&q=85&s=9c871c0568728e37c7fa68e36e6780bd" alt="The General settings with a callout for the Product Type field" width="943" height="589" data-path="img/product-general-settings.png" />

4. (**If applicable**) If you haven't already done so, set **Product Usage** to **Configurable Product with Options**. You must set the product usage to configurable product with options in order to assign option values to the product.

5. In the **Options** section, set the **Pricing Mode** for the product variants. The pricing mode controls how you specify the price and weight for each product variant. Refer to [Product Variant Pricing and Weight](/pages/product-variations#product-variant-pricing-and-weight) for more information.

6. Click **Select Values**. The Edit Variants window appears.

7. In the **Edit Variants** window, select **Update Options**:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/vX_cCc72BnHnRWN5/img/update-variant-options.png?fit=max&auto=format&n=vX_cCc72BnHnRWN5&q=85&s=51aaf2eefb78453551748707f81d3a2b" alt="The Edit Variants module with a callout for the Update Options button" width="1796" height="452" data-path="img/update-variant-options.png" />

8. In the **Child Products** window that appears, select all applicable option values that you want to assign to the product and click **Save**: <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/select-child-products.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=a95718091a873966d91c4561f16e40c5" alt="The Child Products module with callouts for several example options and the Save button" width="624" height="862" data-path="img/select-child-products.png" />\
   When you select an option value, Kibo eCommerce automatically creates a product variant for that option value. Refer to [Product Variations](/pages/product-attributes-overview) for more information.

9. Back in the **Edit Variants** window, complete the following actions:
   * Enable each product variant.
   * (**Optional**) Specify a unique **Product Code**. If you choose to not specify a unique product code for the variant, Kibo eCommerce automatically creates a product code based on the base product's code. Refer to [Product Variant Codes](/pages/product-variations#product-variant-codes) for more information.
   * Depending on the **Pricing Mode** you previously selected, specify the price and weight of each product variant.
   * Click **Save**.

     <img src="https://mintcdn.com/kibocommerce-59e68a4a/IIUyhCjtFT3x5IDQ/img/edit-product-variants.png?fit=max&auto=format&n=IIUyhCjtFT3x5IDQ&q=85&s=b04cd52165badb5839918393e8b10148" alt="The Edit Variants module with callouts for the Enabled, Product Code, List and Sale Price, and Weight columns and Save button" width="1182" height="520" data-path="img/edit-product-variants.png" />

10. Click **Save** in the product editor to save your changes.
