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

# Extra Attributes

Extra attributes include add-on configurations that a shopper configures and usually includes an extra price, such as a monogram or gift wrapping.

You can also make another product an extra, known as a product extra, such as a camera mount that can be sold along with a camera.

## Create Extra Attributes

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

To create an extra attribute:

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

2. Click **Create New Attribute**.

3. In the **Attribute Label** field, enter the name of the extra 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 extra.

6. Use the **Input Type** drop-down menu to select how the extra stores its values. For example, if you create an extra for monogramming then you may want the extra to store text inside of a box/field.

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

7. In the **Attribute Type** field, select **Extra**:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/select-extra-attribute-type.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=d773227799fedf0d130d5da2c6ebca61" alt="Close-up of the Attribute Type field set to Extra" width="248" height="103" data-path="img/select-extra-attribute-type.png" />

   Depending on the input type you selected, this field either appears as a list of checkboxes or a drop-down menu. For the list input type, you can select multiple attribute types. Ensure that you at least select **Extra**.

8. (**If applicable**) In the **Data Type** field, select the data type of the extra's values.\
   For example, you're creating a monogramming extra, and you want the values to be text for the monogram text shoppers will enter.\
   For the list input type, you can select either **Text**, **Number**, or **Product**.

9. (**Text box only**) In the **Min char/val** and **Max char/val** fields, enter the minimum and maximum amount of characters allowed in the extra's value as applicable.

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/property-min-max.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=a24661cd3fe3c45c654d5160e75f0855" alt="Close-up of the Minimum and Maximum Value fields" width="334" height="226" data-path="img/property-min-max.png" />

10. (**Text box only**) In the **Input Validation** field, enter any RegEx which you want to use to validate the characters in the extra's value.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/property-input-validation.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=c95e1c7ad204925ccaa22b6458540921" alt="Close-up of the Input Validation field" width="326" height="112" data-path="img/property-input-validation.png" />

    For example, you want to restrict the allowed characters to only letters, numbers, underscores, whitespace characters, and common punctuation marks. You can enter the following RegEx to accomplish this: `^[a-zA-Z0-9_\s\.\,\!\&\?]*$`.

11. (**Text area only**) In the **Max char.** field, enter the maximum amount of characters to which you want to limit the extra's text box value.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/property-max-char.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=0bec824d190ea93c48c3b895706dfaca" alt="Close-up of the Maximum Characters field" width="297" height="114" data-path="img/property-max-char.png" />

    For example, you're creating a gift message extra and you want to limit the text box value to a maximum of 250 characters.

12. (**Date only**) In the **Valid Date Range** field, enter the start and end dates to restrict the dates that the extra's value can have.

    <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/property-date-range.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=2377797277f865396259c70f87aed8c7" alt="Close-up of the Valid Date Range field" width="518" height="116" data-path="img/property-date-range.png" />

13. (**List only**) In the **Values** section, add all possible values for the extra. You can perform the following actions depending on the data type you selected:
    * **Product Data Type:** Select all applicable products to add to the list:

      <img src="https://mintcdn.com/kibocommerce-59e68a4a/kEyyjskaCtclt2xU/img/select-product-extra-values.png?fit=max&auto=format&n=kEyyjskaCtclt2xU&q=85&s=6f552794e7792ad15d33606b5ed79f0b" alt="The Values section with the Data Type set to Product and a list of example options" width="1316" height="647" data-path="img/select-product-extra-values.png" />

      You can only add existing products that are associated with the same master catalog with which the extra attribute is associated. You can customize the label that appears for the product extra in your storefront using the **Storefront Label** field; otherwise the product's catalog name will appear in your storefront.
    * **Number or Text Data Type:** Enter all applicable values to the list:

      <img src="https://mintcdn.com/kibocommerce-59e68a4a/IIUyhCjtFT3x5IDQ/img/enter-extra-text-values.png?fit=max&auto=format&n=IIUyhCjtFT3x5IDQ&q=85&s=09ae0c329302e9157ed8ff60b4edde25" alt="View of a product attribute table with example labels and values" width="1313" height="619" data-path="img/enter-extra-text-values.png" />

      Press **Enter** after typing each value to add it to the list.

14. For either value data type, 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.

15. Select the **Search Options** for the extra:
    * **Available to Storefront Search:** This determines whether the extra's label or extra's values are matched on when shoppers perform a search on the site. For example, you have a gift wrapping extra and one of its values is *Yes*. If you select this checkbox and **Search Label**, and a shopper performs a search for the term "gift wrapping" on your site, the product will be returned in the search results even if the term "gift wrapping" 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 extra 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.

16. If you have enabled [](/pages/catalog-structure#multi-locale-catalogs "Catalog Structure")[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" />

17. Click **Save**.

## Add Extras to Product Types

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

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

To add an extra 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 **Extras** section, click **Add**:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/v4PoNWPrY1Z21K53/img/add-extras-to-product-type.png?fit=max&auto=format&n=v4PoNWPrY1Z21K53&q=85&s=327b163d97b7d34f831a0c190d468aaa" alt="Close-up of the Extras section header with a callout for the Add button" width="568" height="188" data-path="img/add-extras-to-product-type.png" />

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

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/select-extra-attribute.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=99b6d8d70c50798181d496806754acec" alt="Close-up of the Attribute selection menu with a callout for the Monogram Color example option" width="477" height="538" data-path="img/select-extra-attribute.png" />

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

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

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/vX_cCc72BnHnRWN5/img/values-extra-properties.png?fit=max&auto=format&n=vX_cCc72BnHnRWN5&q=85&s=6ea1aca1153a94b257417fe4c2613e31" alt="Close-up of a Values list with example options" width="395" height="468" data-path="img/values-extra-properties.png" />

   The selected values appear in the Selections list:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/11fMEclnoleINoq4/img/extra-value-selections-list.png?fit=max&auto=format&n=11fMEclnoleINoq4&q=85&s=7f985f0c381349881a67aea329617583" alt="The selected options in the Selections list" width="512" height="476" data-path="img/extra-value-selections-list.png" />

   You can reorder the values in the Selections list.

   The order of the extra values in the Selections list is the order that Kibo eCommerce displays them on your storefront, for example:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/storefront-extra-options.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=779ba0f2f2696824601a0b6a809fd7e3" alt="Example of ordered Monogram Color options on the storefront product page" width="253" height="236" data-path="img/storefront-extra-options.png" />

6. Decide whether the extra 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 extra value to the product in order for Kibo eCommerce to consider the product valid for the product type.

7. Decide whether to **Allow Multi Select** for the extra.\
   If you select this checkbox, you can select multiple values for the extra when creating a product.

8. Click **Done** to finish adding the extra to the product type:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/Tt_xgrUgWofJH_Sj/img/set-extra-configurations.png?fit=max&auto=format&n=Tt_xgrUgWofJH_Sj&q=85&s=9c7e440a081d7cfcda9543fb3caf700f" alt="The Extras configuration module with example values and a callout for the Done button" width="1804" height="616" data-path="img/set-extra-configurations.png" />

## Assign Extra Values to Products

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

For example, you added a monogram text color extra and selected all applicable monogram text color values for the shirt product type. Then when you create a new shirt product, you can assign all applicable monogram text color value to that specific shirt product.

To assign an extra 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 [Create Products](/pages/configure-products#create-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 set to Shirt" width="943" height="589" data-path="img/product-general-settings.png" />

4. (**If applicable**) If you haven't already done so, assign the applicable **Product Usage** to the product.

5. Under the **Extras** section, select the applicable extra for the product:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/v4PoNWPrY1Z21K53/img/add-extra-to-product.png?fit=max&auto=format&n=v4PoNWPrY1Z21K53&q=85&s=3afe2b353bc6a70b6211a9e371c862a5" alt="Close-up of the Extras configuration page with a callout for the Add Extra field and Monogram Color value" width="696" height="337" data-path="img/add-extra-to-product.png" />

6. For each selected extra, select all applicable extra values to assign to the product:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/v4PoNWPrY1Z21K53/img/add-extra-values-to-product.png?fit=max&auto=format&n=v4PoNWPrY1Z21K53&q=85&s=d84a540aecb8fd2889237e62e73f5e5e" alt="Close-up of the Monogram Color extra and the drop-down menu of available values" width="648" height="465" data-path="img/add-extra-values-to-product.png" />

7. For each selected extra value, specify the following:

   <img src="https://mintcdn.com/kibocommerce-59e68a4a/oxyFIw0lhrsaoTmk/img/configure-extras-on-product.png?fit=max&auto=format&n=oxyFIw0lhrsaoTmk&q=85&s=232ad5a01c2515f79a186142d3706edc" alt="The Monogram Color extra with selected values, Required by Shopper and Allow Multi Select toggles, and callouts for the price, weight, and default settings" width="1773" height="498" data-path="img/configure-extras-on-product.png" />

   1. **Price:** The price a shopper must pay for the extra value.
   2. **Quantity** (**Product data type only**): The quantity of the product extra that a shopper must purchase. If you track inventory for the product, keep this quantity in mind when tracking inventory quantities for the product. Refer to [Inventory Management](/concept-guides/inventory) for more information.
   3. (**If applicable**) **Weight:** The weight of the extra value.
   4. **Defaulted:** If selected, Kibo eCommerce automatically selects the extra value on the product details page in your storefront.

8. Decide whether the following settings are applicable for the extra:
   * **Required by Shopper:** If selected, shoppers must select a value for the extra in order to add the product to their cart. If you enable this setting and the extra is out of stock, eCommerce displays an out of stock message on the base product's display page in the storefront and shoppers cannot purchase the base product.
   * **Allow Multi Select:** (**List input type only**) If selected, shoppers can select multiple values for the extra.

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