HomeDev guideAPI ReferenceGraphQL
Dev guideUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Customized Commerce + Search & Navigation

Describes the integration of Optimizely Search & Navigation with Optimizely Customized Commerce. The integration ensures that, after you implement search features, Search & Navigation treats Optimizely Customized Commerce catalog content like regular content.



This integration requires Optimizely Customized Commerce version 8.8 or higher.

Integration packages

  • EPiServer.Commerce.FindSearchProvider – Integration with Optimizely Customized Commerce back-end parts using the Find (Search & Navigation) search provider.
  • EPiServer.Find.Commerce – Optimizely Customized Commerce integration based on the Find (Search & Navigation) API.

You can use EPiServer.Commerce.FindSearchProvider, EPiServer.Find.Commerce, or both. The Commerce.FindSearchProvider package uses Optimizely Search & Navigation (Find) as a search provider in Commerce Manager and the ECF search APIs. The Find.Commerce package uses Optimizely Search & Navigation to search catalog items using the Find API. See Configure Optimizely Search & Navigation search provider in the Customized Commerce developer guide.

Integration components

The EPiServer.Commerce.FindSearchProvider provides the following functionality:

  • Catalog items included in Unified Search results – Projections are configured for Url, ImageUri, and object getter for inheritors of EntryContentBase.
  • Catalog items available when creating best bets – The Search & Navigation Best Bets UI lets you select catalog items.
  • Enhanced indexing of catalog items – Indexing includes catalog languages.
  • Search provider for catalog items – Catalog items can be searched using Search & Navigation in Optimizely edit view.


  1. Add the Optimizely.Commerce.FindSearchProvider package to the Commerce Manager project using the Package Manager Console (Tools > NuGet Package Manager > Package Manager Console).

    Command: Install-package Optimizely.Commerce.FindSearchProvider

  2. Add the EPiServer.Find.Commerce, EPiServer.Find.Cms, and EPiServer.Find.Framework packages to the CMS project. Run the following command on the CMS project.

    Command: Install-package EPiServer.Find.Commerce



    Ensure that you do not install the EPiServer.Find.Cms package on the Commerce Manager project by mistake.

  3. Run the Find content indexing scheduled job. EPiServer.Find.Commerce adds data to indexed documents, so indexed documents only match expected search results after reindexing content.