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


Describes search functionality (Optimizely Search & Navigation), which is a cloud-ready extension that lets you build advanced customized search features based on your content model.

Optimizely's recommended search functionality is Optimizely Search & Navigation, a cloud-ready extension that lets you build advanced customized search features based on your content model. If you use the Optimizely Digital Experience Platform (DXP), Optimizely Search & Navigation is automatically included in your installation. Otherwise, it requires a separate license.

You can use basic query-based search features based on the Lucene search engine for non-cloud environments. To use this search functionality, the NuGet packages EPiServer.Search.Cms and EPiServer.Search must be installed; see Install and deploy Search Service (Legacy).

Search in Optimizely Commerce is also based on Lucene.

Optimizely Search features

Optimizely Search has the following features:

  • Global search
    Search across content types such as pages, blocks, files, videos, images, product content in a Commerce product catalog, and community content. Built-in filtering limits the search results to the type of content.



    You do not get search results on content in blocks added in a content area in a template. Usually, this is not a problem because blocks are often used to promote content in a specific source page, which are found when performing the search.

  • Static facets
    Facets are a type of filtering or grouping where you present groups (facets) of content to limit the search after getting the first query from the user. You can search on categories and content types and define which category and type facets you want to filter.
  • Access-based search result filtering
    Search results are filtered by access rights, ensuring users see only content they can access.
  • Pluggable search interface
    You can replace the built-in Lucene indexing with another index without changing the code on the client, which uses the same API when searching.
  • Instant search
    The most important related information displays as you type the search phrase and becomes more specific as you type more characters.