Skip to end of metadata
Go to start of metadata

In this topic:

Similar to Sitecore, the Coveo Search Provider is highly configurable and has many different configuration files. This page explains the roles of the different Coveo configuration files.

Locating and Identifying the Configuration Files

Configuration Folders

The Coveo for Sitecore configuration files are located with the other Sitecore configuration files under [your instance]\Website\App_Config\Include. Depending on your Sitecore version, the Coveo configuration is located in one to three folders:

  1. \Coveo
  2. \ExperienceAnalyticsCoveo
  3. \ExperienceProfileCoveo

Coveo Folder

This folder can be found on every Sitecore versions. It contains the configurations of the Coveo Search Provider and of the different search components and the Coveo for Sitecore UI.

In this folder, you can find:

  1. Coveo.CloudPlatformClient.config: contains configuration of the module responsible for interacting with the Coveo Cloud platform.
  2. Coveo.CloudPlatformClient.Custom.config: contains custom configuration of the module responsible for interacting with the Coveo Cloud platform.
  3. Coveo.SearchProvider.config: contains the Coveo indexes definitions and the default configuration of the Coveo Search Provider. No modification should be done to this file.
  4. Coveo.SearchProvider.Custom.config: contains the custom configuration of the Coveo Search Provider and pipeline examples. This file is meant to be modified.
  5. Coveo.SearchProvider.Licensing.config: contains the different commands used to open Coveo wizards.
  6. Coveo.SearchProvider.Rest.config: contains the configuration of the REST endpoint used to query the Coveo index. It also includes configurations related to search results handling. No modification should be done to this file.
  7. Coveo.SearchProvider.Rest.Custom.config: contains the custom configuration of the REST endpoint and pipeline examples. This file is meant to be modified.
  8. Coveo.UI.Controls.config: this file is responsible for the configuration related to the integration of Coveo JS Framework in the Sitecore page editor.
  9. SwitchMasterToWeb.Coveo.config.example: useful when configuring Sitecore in a CM/CD configuration. Activate only on CD instances.

ExperienceAnalyticsCoveo Folder

This folder contains a single configuration file: Coveo.Analytics.xDB.config, which defines the Coveo components related to Sitecore xDB. It can be found on instances of Sitecore 7.5+.

ExperienceProfileCoveo Folder

This folder also contains a single configuration file: Coveo.ExperienceProfile.config, which defines the Coveo for Sitecore processors to report Coveo search page events to Sitecore xDB. It can be found on instances of Sitecore 7.5+.

Configuration File Types

Most Coveo configuration files are split into two categories:

  1. .config files

  2. .Custom.config files

The .config files contain the out-of-the-box configurations of Coveo for Sitecore, while the .Custom.config files contain configuration examples and the configurations generated by Coveo UIs (e.g.: the post installation wizard). Because the Sitecore wizard treats .config files in alphabetical order, the configurations in the .Custom.config files take priority over the .config files. If you need to modify your configurations, you are thus encouraged to do so in the .Custom.config files; otherwise, you may encounter unexpected bugs during updates.

Icon

Coveo recommends the use of patching to configure the Coveo Search Provider. This practice makes Coveo for Sitecore updates easier and facilitates debugging.

  • No labels