Adobe Commerce only. Learn more.

Add Facets

Any filterable product attribute can be used as a facet. The Add facets panel lists the current facets and makes it easy to assign additional product attributes as facets. During this three-step process, an attribute is chosen to be used as a facet, properties are edited if needed, and the changes published to the storefront.

Faceting workspace Add facet

Step 1: Add a facet

  1. In the Admin, go to Marketing > SEO & Search > Live Search.
  2. On the Faceting tab, click Add facets.
  3. In the Add facets list, each available attribute has a separate Add button. Do one of the following:

    • In the Faceting Attributes list, choose the product attribute that you want to use as a facet and click Add.
    • To find a specific product attribute, enter the first few characters of the attribute name in the Search box. Then, click Add.

    To learn more, go to Facet Types.

    The facet is added to the bottom of the Dynamic Facets list and the Publish changes button becomes available.

  4. If the facet you want to add can’t be found, go to Stores > Attributes > Product and verify that the attribute has the required properties to be used as a facet. If necessary, update the following storefront properties of the attribute:

    • Use in Search - Yes
    • Use in Search Results Layered Navigation - Yes
    • Use in Layered Navigation - Filterable (with results)
    • Use in Search Results Layered Navigation - Yes
  5. When prompted, refresh the cache.

    The facet becomes available in the storefront the next time the catalog is synchronized with Live Search. Depending on the index mode that is set for the Product Attributes Feed, it can take some time for the updated attribute to appear in the list of available facets. For best results, set the index mode for the Product Attribute Feed to Update on Schedule.

    If the facet isn’t available after two hours, see Verify Catalog Sync in the developer documentation.

Step 2: Edit facet properties (Optional)

Refer to Settings to configure price faceting intervals and groupings.

  1. If you need to edit the facet properties, click More (More selector) options in the far-right column.
  2. On the menu, click Edit. Then, adjust the following properties as needed.

    • Label - (Headless only) Enter the facet label that you want to use.
    • Select type - The Select type used for all Commerce storefronts is single select. For headless implementations, multi-select type can be assigned with a logical operator (or or and) to determine the set of products returned.
    • Sort type - Facets are sorted alphabetically for all Commerce storefronts. For headless implementations, facets can be sorted either alphabetically or by count. Options: Alphabetical, Count (headless only)
    • Max Value - Enter the maximum number of facet values displayed in the storefront. Valid entries: 0 - 10
  3. When complete, click Save.

    Faceting workspace Edit facet

  4. To pin the facet to the top of the Filters list, click the gray pushpin (Pin selector).
  5. To change the order of the pinned facet, click the Move (Move selector) icon and drag the row to a new position in the Pinned Facets section.

Step 3: Publish changes

  1. When the facet is complete, click Publish changes.
  2. Wait for the facet to appear in the store.

    If the facet isn’t available after two hours, see Verify catalog sync in the developer documentation.

    Faceting workspace Publish changes

Field Descriptions

Field Description
Label (Headless only) The facet label that is visible to the shopper. You can edit the label to be consistent with your brand.
Select type Refers to the selection method that is used to choose a facet value as a filter. All Commerce storefronts support Single select only. Headless implementations also support Multi-select with the logical operators OR and AND.
Sort Type The method that is used to sort facet values. All Commerce storefronts sort facets alphabetically only. Headless implementations can also sort by Count. Options:
Alphabetical - Sorts facet values alphabetically.
Count - (Headless only) Sorts facet values based on the number of matches found.
Max Value The maximum number of values that can be displayed in the storefront for each facet. Facets that represent a range of values are evenly distributed. Default: 8

Controls

Control Description
Pin selector Pins or unpins a facet to the top of the Filters list.
More selector Displays a menu of more actions that can be applied to the selected facet. Options: Edit, Delete
Move selector Use the Move icon to drag a pinned facet to another place in the Pinned facets section.