Facets

Faceted search is the ability to narrow a search based on one or more dimensions.

Overview

When using Ucommerce, you can create a custom index definition that specifies which built-in or user-defined properties on your products should be generated as facets. Once you have completed this step, any queries against the index will return facets and their respective values, as shown in the image below.

Faceted search example

Creating a facet

When you want to enable faceted search for a field, your index definition needs to define the field to be part of the index as well as tell the system that this field should be faceted.

this.Field(p => p["Coupons"], typeof(UserDefinedEnum))
    .Facet();

The search API will automatically retrieve all possible values for facets.

Price facets

Depending on the price indexing mode, prices can be different than most other fields. See Indexing Prices for more details.