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


The Episerver integration builds on the .NET client API, adding functionality for automatically indexing objects, and methods for filtering, retrieving, and caching results. This topic describes how to integrate Episerver Search & Navigation (formerly Episerver Find) with your solution.


To use the Episerver integration, you need the Episerver Search & Navigation .NET API and these assemblies:

  • Episerver.Find.Framework.dll
  • EPiServer.Find.Cms.dll

The assemblies are installed from the Episerver NuGet feed (on http://nuget.episerver.com/feed/packages.svc/). Install the packages using NuGet, as described in Installing Episerver updates.

Reference all assemblies in your project, and add the standard configuration for the .NET API to web.config.


When working with the general .NET API, you typically create an instance of the IClient class using the Client.CreateFromConfig method. Following the general pattern of Episerver development, the Episerver integration provides a singleton instance in the form of the SearchClient class and its Instance property. The returned instance is a regular IClient, but some modifications are made to it at start up. In other words, when working with Episerver and Episerver Search & Navigation, be sure to use SearchClient.Instance.

Note: Differences between the authentication mechanism of EPiServer.ServiceAPI and EPiServer.Find may lead to the incorrect functioning of user authentication. To avoid these problems, it is recommended to install EPiServer.ServiceAPI in a separate application.

Related topic

Do you find this information helpful? Please log in to provide feedback.

Last updated: Oct 31, 2016