Creating Product Attributes

You can create attributes while working on a product or from the Product Attributes page. The following steps show how to create attributes from the Stores menu.

New Attribute Properties

Step 1: Describe the basic properties

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

  2. Click Add New Attribute.

    Add new product attribute Attribute Properties

  3. Under Attribute Properties, enter a Default Label to identify the attribute.

  4. To determine the type of input control that is used for data entry, set Input Type to one of the following:

    Property Description
    Text Field A single line input field for text.
    Text Area A multiple-line input field for entering paragraphs of text, such as a product description. You can use the WYSIWYG Editor to format the text with HTML tags, or enter the tags directly into the text.
    Text Editor A fully-functioning text editor at the attribute location.
    Date Displays a date value in the preferred format and time zone. Date values can be selected from a list or a calendar ( Calendar icon ).

    Note: Depending on your system configuration, Admin users can enter dates directly into a field or select a date from the calendar or list. For information about specifying date and time values, see Date and Time Custom Options.
    Yes/No Displays a drop-down list with pre-defined options of Yes and No.
    Dropdown Displays a drop-down list of values that accepts only a single selection. The Dropdown input type is a key component of configurable products.
    Multiple Select Displays a drop-down list of values that accepts multiple selections.
    Price This input type is used to create price fields that are in addition to the predefined attributes: Price, Special Price, Tier Price, and Cost. The currency used is determined by your system configuration.
    Media Image Associates an additional image with a product, such as a product logo, care instructions, or ingredients from a food label. When you add a media image attribute to the attribute set of a product, it becomes an additional image type, along with Base, Small, and Thumbnail. The media image attribute can be excluded from the storefront media browser.
    Fixed Product Tax Lets you define FPT rates based on the requirements of your locale.
    Visual Swatch Displays a swatch that depicts the color, texture, or pattern of a configurable product. A visual swatch can be filled with a hexadecimal color value, or display an uploaded image that represents the color, material, texture, or pattern of the option.
    Text Swatch A text-based representation of a configurable product option that is frequently used for size. Text swatches can also include hexadecimal color values.
    Page Builder A fully-functioning Page Builder workspace at the attribute location that makes it easy to add engaging content to the product page.
  5. If you want to require an option selection before the customer can purchase the product, set Values Required to Yes.

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

    • Under Manage Options, click Add Option.

    • 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 Option 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.

    Product attribute - manage options Manage Options

Step 2: Describe the advanced properties (if needed)

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

    Product attribute - advanced properties Advanced Attribute Properties

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

  3. If you want to prevent duplicate values from being entered, 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. 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 product grid, set the following options to Yes.

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

Step 3: 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.

    Product attribute - manage titles Manage Titles

Step 4: Describe the storefront properties

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

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

  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.

    • In the Position field, 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.

    Product attributes - storefront properties Storefront Properties

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:

Property Value
Catalog Input Type for Store Owner Dropdown
Scope Global