Step 2: Describe the advanced properties (if needed)

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

    NOTE
    It is not recommended to use the type value in the Attribute Code field. This can cause errors because the type value is reserved for system use.

    Product attribute - advanced properties

    The available options depend on the Catalog Input Type for Store Owner setting.

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

  3. If you want to prevent any duplicate value entry, set Unique Value to Yes.

  4. For input types that are entered values, run a validity test of any data entered into a text field by setting 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. The test can validate any of the following:

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

    Input validation

  5. To add this attribute to the Products list, set the following options to Yes.

    • Add to Column Options - Includes the attribute as a column in the Products list.
    • Use in Filter Options - Adds a filter control to the column header in the Products list.

Step 3: Enter the field label

  1. In the left side navigation, choose Manage Labels.

  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.

    Product attribute - manage titles

Step 4: Describe the storefront properties

  1. In the left side navigation, choose Storefront Properties.

    Product attributes - storefront properties

    The available options depend on the Catalog Input Type for Store Owner setting.

  2. If the attribute is to be available for search, set Use in Search to Yes.

    • Set the Search Weight value to control where the item appears in search results: 1 (lowest weight) to 10 (highest weight).

    • Set the Visible in Advanced Search as needed. Learn more in Advanced Search.

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

  4. For dropdown, multiple select, and price fields, do the following:

    • To use the attribute as a filter in layered navigation, set Use in Layered Navigation to Yes.

    • To use the attribute in layered navigation on search results pages, set Use in Search Results Layered Navigation to Yes.

    • For Position, enter a number to indicate the relative position of the attribute in the layered navigation block.

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

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

    This setting makes the WYSIWYG editor available for the field.

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

  8. Complete the following settings if 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.

  9. When complete, click Save Attribute.

Step 5: Assign the created attribute to the attribute set

For an attribute to be visible on the product creation page, add it to a specific attribute set.

  1. After completing previous steps, go to Stores > Attributes > Attribute Set.

  2. Select the attribute set you need in the list, and open it in edit mode.

  3. Drag the created attribute from the Unassigned Attributes list to the appropriate folder in the Groups column.

  4. When complete, click Save.

Attributes for configurable products

Any attribute that is used as a drop-down list of options for a configurable product must have the following properties:

PropertyValue
Catalog Input Type for Store OwnerDropdown
ScopeGlobal

Delete an attribute

When an attribute is deleted, it is removed from any related products and attribute sets. System attributes are part of the core functionality of your store and cannot be deleted.

Before deleting an attribute, make sure that it is not currently used by any product in your catalog. An easy way to determine if an attribute is in use is to use the Export tool to check the list of product Entity Attributes. If the attribute is not included in the list, then it is not used by any products in the catalog.

To delete an attribute:

  1. On the Admin sidebar, go to Stores > Attributes > Product.

  2. Find the attribute in the list, and open in edit mode.

  3. Click Delete Attribute.

    Delete attribute

  4. When prompted to confirm, click OK.

Previous pageProduct swatches
Next pageBulk updates

Commerce