Area: Optimizely Search & Navigation
Applies to versions: 12 and higher
Other versions:

Histogram facets

Recommended reading 

Facets are used for grouping documents based on for example specific terms or date range. This topic explains how facets based on histograms are used in Optimizely Search & Navigation.

How it works

Use histogram facets with numerical and date fields to retrieve the number of documents whose field value falls within an interval. For example, in a search of products, use a histogram facet to retrieve the number of products whose price ranges from 0 to 100, 101 to 200, and so on.

Use the HistogramFacetFor method to request histogram facets for numerical and date fields.

  • The first parameter takes an expression which determines the field for which to build the histogram. For example, PublishDate.
  • The second parameter requires an interval, either a numerical value or a value of the enum type DateInterval (located in the EPiServer.Find.Api.Facets namespace). This parameter is based on the field defined in the first parameter.

After the search is executed, extract histogram facets from the search results object using the method with the same name, HistogramFacetFor.


After searching blog posts, you want to display the number of posts for each publication month.

//Perform the search with the facet request included
var result = client.Search<BlogPost>()
  .HistogramFacetFor(x => x.PublishDate, DateInterval.Month)

//Retrieve the histogram facet for publication dates
var publicationMonths = searchResult
  .HistogramFacetFor(x => x.PublishDate);

//Iterate over the facet extracting values
foreach (var interval in publicationMonths.Entries)
    DateTime month = interval.Key;
    int count = interval.Count;

//Retrieve the count for a specific month
int? januaryCount = publicationMonths[new DateTime(2010, 12, 1)];
Do you find this information helpful? Please log in to provide feedback.

Last updated: Oct 31, 2016

Recommended reading