Welcome to the navigation

Dolor do eiusmod fugiat enim occaecat veniam, consectetur magna duis eu in dolore mollit commodo non laborum, ex adipisicing in cillum sunt voluptate proident, anim. Ut reprehenderit sunt id in officia irure eu eiusmod laboris enim veniam, nulla minim elit, dolore culpa dolore consequat, cillum adipisicing excepteur aliqua, sed ut

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