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


If you already have a website to which you want to add Optimizely Search & Navigation, skip the website creation step. After completing this step, you are ready to start developing.

Note

Optimizely Search & Navigation was formerly known as Episerver Find.

## Create the website

Follow [Install CMS 11 and Commerce 13](🔗) for Optimizely Content Management System (CMS). Select **Alloy (MVC)** to create a sample website based on MVC. Let the installation finalize, and open the website in a browser to ensure it works properly.

CMS 12 and Commerce 14

For Optimizely Content Management System (CMS 12) and Optimizely Customized Commerce version 14, see [Install Optimizely (ASP.NET Core)](🔗).

## Add Optimizely Search & Navigation to the website

Ensure that the [Optimizely NuGet feed](🔗) is added as a package source for the website for which you want to add Optimizely Search & Navigation. If you installed the CMS sample site, this is automatically added.

CMS 11 and Commerce 13

If you selected the **Episerver Find** when you [installed CMS 11 and Commerce 13](🔗), you can skip this step.

  1. In Visual Studio, use Solution Explorer to open the website.

  2. Right-click on **References**, and select **Manage NuGet Packages, Online** and **EPiServer**.

  3. Locate the _EPiServer.Find.Cms_ package and click **Install**.

700

  1. Verify that Search & Navigation components are added under your project **References**.

## Configure Optimizely Search & Navigation for the website

  1. Log in to your account on the [Search & Navigation](🔗) site, go to **My Services**, and click index **Details**.

  2. Copy the configuration code snippet displayed for the _web.config_ file.

  3. Go to your solution in Visual Studio, open the_appsettings.json_ file, and paste the configuration code into the relevant sections. The code to paste looks something like this:



Also enter `AddFind() Startup.cs`. You can also configure the index using `FindOptions` from code.


  1. Rebuild the project and verify that the site is running properly.

Note

To ensure maximum availability and scaling flexibility, Search & Navigation uses dynamic IP ranges. For example, if you require whitelisting of IP addresses in the firewall, make sure that your firewall supports domain-based whitelisting.

## Index the website

  1. Log in to the site.

  2. Go to the CMS admin view.

  3. Select **Find Indexing Job **and click** Start Manually**. This action indexes the site content. You do not need to set up the [Scheduled job for indexing](🔗) to run automatically because content changes are instantly indexed.

  4. Log in to the CMS edit view, go to **Find  > ** **Overview >** **Explore** to view the index. For the sample site, you see something like this:



Note

If multiple sites are associated with the index, objects from other sites may appear. See [Indexing](🔗) for information about how indexing works.