AppSettings

There are 3x required appSettings:

<add key="ExamineX.AzureSearchServiceName" 
     value="your-azure-cognitive-search-service-name" />

<add key="ExamineX.SiteFriendlyName"
     value="Your site's Friendly name associated with your license" />

<add key="ExamineX.AzureSearchKey" 
     value="YOUR-AZURE-COGNITIVE-SEARCH-SERVICE-KEY" />

The ExamineX.SiteFriendlyName setting is associated with your license and must the same value you used when creating your license. If you are trialing ExamineX then you can enter any site friendly name and then if purchasing you should use the same name. This setting is also used to name the indexes in your Azure Search service.

Staging sites

The Standard licenses type supports staging indexes. An optional appSetting can be used to configure a staging site up while running under the same single license. These 2 staging options provide the flexibility you may require to have staging site indexes in either a separate search service or separate indexes within the same search service depending on your requirements.

By Index

<add key="ExamineX.StagingType" value="ByIndex" />

If this config option is applied, then the index names within the same search service will be suffixed with -staging. For example, for the Internal index with a friendly site name of “My Website”, the index name would now be my-website-internal-staging

By Service

<add key="ExamineX.StagingType" value="ByService" />

If this config value is applied, then the search service that will be used will be the search service name suffixed with -staging. For example, if you’re search service name is “website-search” then this will configure indexes and the client to use a search service called website-search-staging

NOTE: Any other value specified for this optional app setting will just be treated as if there is no staging configured.

Disabling Specific Indexes

It is possible to disable specific indexes from being initialized with ExamineX. In cases where you want to use the free tier of Azure search which limits you to 3 indexes total, you may wish to disable one of ExamineX indexes and let it remain as a default Lucene index instead. This is generally only useful if the index you are disabling isn’t used. As an example, you may not use the Members index in your site but you want to use the Umbraco Forms index. By disabling the Members index this now provides you with a free index to use for Umbraco Forms.

Replace the {IndexName} token with the Examine index name you wish to disable in ExamineX.

<add key="ExamineX.Umbraco.Disable.{IndexName}" value="true" />

For example:

<add key="ExamineX.Umbraco.Disable.MembersIndex" value="true" />

Disabling ExamineX

You can disable ExamineX by adding this appSetting:

<add key="ExamineX.Disabled" value="true" />