Facets

Faceting is a method of high-performance filtering that uses multiple dimensions of attribute values as search criteria. Faceted search is similar, but considerably “smarter” than the standard layered navigation. The list of available filters is determined by the filterable attributes of products returned in the search results.

Live Search uses the productSearch query, which returns faceting and other data that is specific to Live Search. Refer to productSearch query in the developer documentation for code examples.

Any defined facet may be used as a URL parameter and results will be filtered based on the parameter values: http://yourstore.com?brand=acme&color=red.

Faceting requirements

The category and product attribute requirements for faceting are similar to the filterable attributes used for layered navigation. The storefront properties of each attribute must be set to filterable (with results).

Live Search supports up to:

• 100 attributes configured as facets
• 50 sortable attributes
• 200 filterable attributes
• 200 searchable attributes

If you have a large number of attributes to contend with, consider combining attributes into a single ‘meta-attribute’. For example, shoes generally have numeric sizes, while shirts are commonly sized “S/M/L/XL”. These two types of sizes can be combined into a single searchable attribute.

Facet aggregation

Facet aggregation is performed as follows: if the storefront has three facets (categories, color, and price) and the shopper filters on all three (color = blue, price is from $10.00-50.00, categories = promotions).

• categories aggregation - Aggregates categories, then applies the color and price filters, but not the categories filter.
• color aggregation - Aggregates color, then applies theprice and categories filters, but not the color filter.
• price aggregation - Aggregates price, then applies the color and categories filters, but not the price filter.

Default attribute values

The following product attributes have storefront properties that are used by Live Search and enabled by default.

Default non-system attribute properties

The following table shows the default search and filterable properties of non-system attributes, including those that are specific to the Luma sample data. Setting the Use in Search attribute property to Yes makes the attribute searchable in both Live Search and native Adobe Commerce.

Default system attribute properties

The following table shows the default search and filterable properties of system attributes.