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

Commerce integration

Recommended reading 

This topic describes the integration of Episerver Search & Navigation (formerly Episerver Find) with Episerver Commerce. The integration ensures that, after you implement search features, Search & Navigation treats Commerce catalog content like regular content.

Note:  The integration requires Episerver Commerce version 8.8 or higher.

Integration packages

  • EPiServer.Commerce.FindSearchProvider. Integration with Episerver Commerce back-end parts using the Find search provider.
  • EPiServer.Find.Commerce. Episerver Commerce integration based on Find API.

Which package to use?

You can use EPiServer.Commerce.FindSearchProvider, EPiServer.Find.Commerce, or both. The Commerce.FindSearchProvider package uses Search & Navigation (Find) as a search provider in Commerce Manager and the ECF search APIs. The Find.Commerce package uses Search & Navigation to search catalog items via the Find API. See Configuring Episerver Search & Navigation search provider in the Episerver 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 all catalog languages.
  • Search provider for catalog items. Catalog items can be searched using Search & Navigation in Episerver edit view.


  1. Add the Episerver.Commerce.FindSearchProvider package to the CMS and Commerce Manager projects using the Package Manager Console (Tools > NuGet Package Manager > Package Manager Console).

    Command: Install-package Episerver.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

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

Related topics

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

Last updated: Jun 17, 2020

Recommended reading