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. Each storefront properties of an attribute must have the “Use in Search Results Layered Navigation” value set to “Yes”.
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.
YesYes/No, Dropdown, Multiple Select, Price, Visual swatch (widget only), Text swatch (widget only)YesFacet 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).
categoriesaggregation - Aggregatescategories, then applies thecolorandpricefilters, but not thecategoriesfilter.coloraggregation - Aggregatescolor, then applies thepriceandcategoriesfilters, but not thecolorfilter.priceaggregation - Aggregatesprice, then applies thecolorandcategoriesfilters, but not thepricefilter.
Default attribute values
The following product attributes have storefront properties that are used by Live Search and enabled by default.
pricepriceskunamepricevisibilitycategory_nameDefault 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.