- Coveo Control Panel Administration Access
- Understanding the Command Center
- Introduction to the Coveo Configuration files
- Understanding the Coveo Search Provider Configuration File
- Overview of Field Management in the Coveo.SearchProvider.config File
- Managing Your License
- Understanding the REST Endpoint Configuration Files
- Changing the Default Coveo for Sitecore REST Endpoint Proxy Path
- Understanding the Cloud Platform Client Pipelines
- Understanding the Coveo UI Pipelines
- Accessing the Coveo for Sitecore API
Introduction to the Coveo Configuration files
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
Sitecore 7 and 8
The Coveo for Sitecore configuration files are located with the other Sitecore configuration files under
[Your Sitecore Instance]\Website\App_Config\Include. Depending on your Sitecore version, the Coveo configuration is located in one to all three of the following folders:
The Coveo for Sitecore configuration files are located in
Coveo folders with the other Sitecore configuration files. The
Coveo folders are located under:
[Your Sitecore Instance]\App_Config\Include\
[Your Sitecore Instance]\App_Config\Modules\
To avoid issues and unexpected behavior, you should refrain from moving the Coveo for Sitecore configuration files from their intended location.
Coveo folder(s) can be found on all Sitecore versions. The files therein store the configurations of the Coveo Search Provider and of the different search components and the Coveo for Sitecore UI.
Coveo folder(s), you can find:
Coveo.Authentication.config: contains configurations related to the automatic authentication into Coveo modules after authentication in Sitecore. No modification should be done to this file.
Coveo.CloudPlatformClient.config: contains configuration of the module responsible for interacting with the Coveo Cloud Platform.
Coveo.CloudPlatformClient.Custom.config: contains custom configuration of the module responsible for interacting with the Coveo Cloud Platform.
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.
Coveo.SearchProvider.Custom.config: contains the custom configuration of the Coveo Search Provider and pipeline examples. This file is meant to be modified.
Coveo.SearchProvider.Fields.Custom.config: contains the list of include fields. This file is automatically generated when using the PATCH or PUT
fieldsservices for the first time. No modification should be done to this file directly.
Coveo.SearchProvider.Licensing.config: contains the different commands used to open Coveo wizards.
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.
Coveo.SearchProvider.Rest.Custom.config: contains the custom configuration of the REST endpoint and pipeline examples. This file is meant to be modified.
Coveo.UI.Controls.config: this file is responsible for the configuration related to the integration of Coveo JS Framework in the Sitecore page editor.
Sitecore 7 and 8
SwitchMasterToWeb.Coveo.config.example: useful when configuring Sitecore in a CM/CD configuration. Activate only on CD instances.
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+.
This folder also contains a single configuration file:
Coveo.ExperienceProfile.config, which defines the Coveo for Sitecore processors to report Coveo-powered 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:
.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’re thus encouraged to do so in the
.Custom.config files; otherwise, you may encounter unexpected bugs during updates.
We recommend the use of patching to configure the Coveo Search Provider. This practice makes Coveo for Sitecore updates easier and eases debugging.