HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In

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.


Optimizely Search & Navigation was formerly known as Episerver Find.

## Create the website

Follow steps 1-2 in [Create the back-end site](🔗) for Optimizely Content Management System (CMS). In step 3, select **Alloy (MVC)** to create a sample website based on MVC. Let the installation finalize, and open the website in a browser to ensure that it is working properly.

CMS 12 and Commerce 14

For Optimizely Content Management System (CMS 12) and Optimizely Customized Commerce version 14, see [Installing Optimizely (.NET5)](🔗).

## 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 12

If you selected the **Episerver Find** option while [installing CMS](🔗), 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**.


  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. In Visual Studio, go to your solution, 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.


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. Note that you do not need to set up the [Scheduled job for indexing](🔗) to run automatically, since 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:


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