DocumentationCommerceCatalog Management

Add attributes to a product

Last update: Wed Aug 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Beginner
  • Intermediate
  • Admin
  • Leader
  • User

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 an attribute. The new attribute is added to the attribute set upon which the product is based.

Step 1: Add an attribute

  1. Open the product in edit mode.

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

    New product with default attribute set {width="600" modal="regular"}

  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.

    Select an attribute {width="600" modal="regular"}

  4. To define a new attribute, click Create New Attribute and complete the items in Step 2.

Step 2: Describe the basic attribute properties

Attribute Properties {width="600" modal="regular"}

  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 is 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 {width="600" modal="regular"}

  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 {width="600" modal="regular"}

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

  2. Set Scope to indicate where in your store hierarchy that 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 {width="500"}

  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 Expansion selector 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 {width="600" modal="regular"}

Step 5: Describe the storefront properties

  1. Expand Expansion selector the Storefront Properties section.

    Storefront Properties {width="600" modal="regular"}

  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 the products that match the filter. The products list is updated only if the selected filters change what is shown.

    • Filterable (no results) - Layered navigation includes filters for all available attribute values and their product counts, including the products with zero (0) product matches. If the attribute value is a swatch, the value appears as a filter, but is crossed out.

    note note
    NOTE
    When the Use in Search setting is set to No, the Use in Search Results Layered Navigation setting is not displayed and the product attribute is not used in the search with any Use in Layered Navigation setting value.

  5. To use the attribute in layered navigation on search results pages, set Use in Search Results Layered 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.

    note note
    NOTE
    The Position field is dimmed by default and you must save the attribute before you can modify this setting.

  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.

recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071