HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket


Introduces facets in Optimizely Search & Navigation. Facets are used for grouping documents based on some criterion, specific terms or date range.

Typical uses are tag clouds and faceted navigation that let site visitors restrict search results to selected categories, such as product types, price ranges, or author names.

Facets provide aggregated data based on a search query and are requested and retrieved along with regular search requests. The search query scopes facets by default.

Elasticsearch, upon which Optimizely Search & Navigation is built, features several facets ranging from simple to advanced.

The .NET client API in Optimizely Search & Navigation supports facets based on:


Facets and filters

Normally, facets are affected by filters, just like search results. However, via the FilterHits method, you can retrieve facets without applying the filters applied to search results . Therefore, it is good to read up on the Filter and FilterHits methods, because there are significant differences between them when working with facets.