After July 2021, the 2.3.x release line will no longer receive quality updates, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x to help maintain PCI compliance.

Adding an Attribute to a Product

The information on this page is intended for Adobe Commerce 2.3 customers who are on an extended support contract. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Although attributes are managed primarily from the Stores menu, you can also add new attributes on the fly while working on a product. You can choose from the list of existing attributes or create a new attribute. The new attribute is added to the attribute set upon which the product is based.

Add Attribute

Step 1: Add a product attribute

  1. Open the product in edit mode.

  2. In the upper-right corner, click Add Attribute.

    New Attribute

  3. To add an existing attribute to the product, use the filter controls to find the attribute in the grid and do the following:

    • Select the checkbox in the first column of each attribute to be added.

    • Click Add Selected.

  4. To define a new attribute, click Create New Attribute and complete the following steps.

Step 2: Describe the basic properties

Attribute Properties

  1. Under Attribute Properties, enter an Attribute Label to identify the attribute.

  2. Set Catalog Input Type for Store Owner to the type of input control to be used for data entry.

    If the attribute is used for a configurable product, choose Dropdown.  Then, set Required to Yes.

  3. For Dropdown and Multiple Select input types, do the following:

    • Under Values, click Add Value.

    • Enter the first value that you want to appear in the list.

      You can enter one value for the Admin and a translation of the value for each store view. If you have only one store view, you can enter only the Admin value, and it will be used for the storefront as well.

    • Click Add Value and repeat the previous step for each option that you want to include in the list.

    • Select Is Default to use the option as the default value.

    Values

  4. If you want to require the customer to choose an option before the product can be purchased, set Required to Yes.

Step 3: Describe the advanced properties (optional)

Advanced Attribute Properties

  1. Enter a unique Attribute Code in lowercase characters and without spaces.

  2. Set Scope to indicate where in your store hierarchy the attribute can be used.

    If the attribute is used for a configurable product, choose Global.

  3. If this attribute applies only to this product, set Unique Value to Yes.

  4. To run a validity test of any data entered into a text field, set Input Validation for Store Owner to the type of data that the field should contain.

    This field is not available for input types with values that are selected. Input validation can be used for any of the following:

    • Decimal Number
    • Integer Number
    • Email
    • URL
    • Letters
    • Letters (a-z, A-Z) or Numbers (0-9)

    Input Validation

  5. If you want to be able to include the attribute as a column in the Products grid, set Add to Column Options to Yes.

  6. If you want to be able to filter the Products grid by this column, set Use in Filter Options to Yes.

Step 4: Enter the field label

  1. Expand the Manage titles section.

  2. Enter a Title to be used as a label for the field.

    If your store is available in different languages, you can enter a translated title for each view.

    Manage Titles

Step 5: Describe the storefront properties

  1. Expand the Storefront Properties section.

    Storefront Properties

  2. To make the attribute available for search, set Use in Search to Yes.

  3. To include the attribute in Product Compare, set Comparable on Storefront to Yes.

  4. To include dropdown, multiple select, or price attributes in layered navigation, set Use in Search Results Layered Navigation to one of the following:

    Filterable (with results) Layered navigation includes only those filters for which matching products can be found. Any attribute value that already applies to all products shown in the list does not appear as an available filter. Attribute values with a count of zero (0) product matches are also omitted from the list of available filters.

    The filtered list of products includes only those that match the filter. The products list is updated only if the selected filter(s) change what is currently shown.
    Filterable (no results) Layered navigation includes filters for all available attribute values and their product counts, including those with zero (0) product matches. If the attribute value is a swatch, the value appears as a filter, but is crossed out.
  5. To use in layered navigation on search results pages, set Use in Search Results Navigation to Yes and enter a number in the Position field.

    The position number indicates the relative position of the attribute within the layered navigation block.

  6. To use the attribute in price rules, set Use for Promo Rule Conditions to Yes.

  7. To allow the text to be formatted with HTML, set Allow HTML Tags on Storefront to Yes.

    This setting makes the WYSIWYG editor available when editing the field.

  8. To include the attribute on the product page, set Visible on Catalog Pages on Storefront to Yes.

  9. Complete the following settings as supported by your theme:

    • To include the attribute in product listings, set Used in Product Listing to Yes.

    • To use attribute as a sort parameter for product listings, set Used for Sorting in Product Listing to Yes.

  10. When complete, click Save Attribute.