Welcome to the navigation

Proident, fugiat esse cillum lorem ut culpa nisi minim anim pariatur, consequat, excepteur in ut ullamco dolor amet, voluptate duis ad qui sint deserunt aliquip. Officia cillum amet, ut adipisicing sunt dolore veniam, duis anim laborum, quis sed nostrud qui culpa sit lorem irure ad esse incididunt pariatur, nisi magna

Yeah, this will be replaced... But please enjoy the search!

Term facets for CategoryList items in EPiServer Find

I needed to use a CategoryList as Facets in EPiServer Find, preferably without modifying or extending the PageData/BlockData objects. Luckily Henrik Lindström wrote a FacetFilter2Find library that helped a bit.

First of

Thanks to Henrik Lindström, Joel Abrahamsson, Marcus Granström and anyone else involved in the x2find libraries.

The problem

Categorylists are stored as integer arrays in EPiFind, also the default TermsFacetFor extension method does not accept Category/CategoryLists objects as arguments.

var result = SearchClient.Instance.Search<ArticlePage>()
        .TermsFacetFor(x => x.Category) // This doesn't work


The FacetFilter2Find didn't quite do the trick out of the box either, but implementing the library gave me access to the necessary objects to build the required extension method, TermsFacetForCategories

/// <summary>
/// Generate facets for the ICategorizable property
/// Extending FacetFilter2Find, https://github.com/x2find/FacetFilter2Find
/// </summary>
/// <typeparam name="TSource"></typeparam>
/// <param name="search"></param>
/// <param name="fieldSelector"></param>
/// <param name="facetRequestAction"></param>
/// <returns></returns>
public static ITypeSearch<TSource> TermsFacetForCategory<TSource>(
    this ITypeSearch<TSource> search,
    Expression<Func<TSource, CategoryList>> fieldSelector,
    Action<TermsFacetFilterRequest> facetRequestAction = null)
    var filterExpressionParser = new FilterExpressionParser(search.Client.Conventions);
    var fieldName = search.Client.Conventions.FieldNameConvention.GetFieldName(fieldSelector);
    var facetFilter = filterExpressionParser.GetFilter<ICategorizable>(x => x.Category.Exists());
    var facetName = fieldSelector.GetFieldPath();

    return new Search<TSource, IQuery>(search, context =>
        var facetRequest = new TermsFacetFilterRequest(facetName, facetFilter)
            Field = fieldName

        if (facetRequestAction.IsNotNull())


To be able to use these extension methods you must download and implement the FacetFilter2Find library from github in your project.


var result = SearchClient.Instance.Search<ArticlePage>()
        .TermsFacetForCategories(x => x.Category, facet => facet.Size = 50)

var categoryFacets = result.Facets["Category"] as TermsFacet;

The returned facets are stored in a normal TermsFacet object containing a Terms list with TermCount objects. 

To resolve the category details simply resolve the Id on each term as a CategoryId.

var categoryFacets = result.Facets["Category"] as TermsFacet;
var categoryRepository = ServiceLocator.Current.GetInstance<CategoryRepository>();

// Anonymous object with category Id, Description, Name and Count
var categoryFacetTerms = categoryFacets.Select(categoryFacet => {
    var category = categoryRepository.Get(int.Parse(categoryFacet.Term));
    return new {
        Id = int.Parse(categoryFacet.Term),
        Description = category.Description,
        Name = category.Name,
        Count = categoryFacet.Count

The above example would result in something like this



Please note that this portal is a BETA site , I will continuously improve all functionality and performance during the coming weeks / the author