Source Control For Coveo For Sitecore Project

When dealing with a Coveo for Sitecore Project, it’s easy to lose track of all the custom changes made. It’s particularly important to track your created and modified files when upgrading Coveo for Sitecore, as new releases are frequent.

Files to Include in Source Control

Here is a list of files that we recommend you include for version control.

Custom .cshtml Files

Typically found under:

Sitecore 7 and 8

  • <SITECORE_INSTANCE_ROOT>\Website\layouts\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\templates\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\init\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\search box init\

Sitecore 9 and 10

  • <SITECORE_INSTANCE_ROOT>\layouts\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\templates\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\init\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\search box init\

Learn more about creating a unique search experience (see Style the Search Experience).

Custom Config Files

Typically found under:

Sitecore 7 and 8  <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\Coveo\

Sitecore 9 and 10  <SITECORE_INSTANCE_ROOT>\App_Config\Include\Coveo\

These files are easily recognizable by their file name which ends with Custom.config and are used to patch the default configuration and behavior of Coveo for Sitecore.

Learn more about configuration files (see Introduction to the Coveo Configuration files).

Your Code Files

You should include whatever code files you have written (e.g., custom processors).

Custom CSS, JS and Image Files

Learn more about inserting custom CSS in your search experience (see Style the Search Experience).

Custom Serialized Sitecore Items

Learn more about serialized items using Unicorn or Team Development for Sitecore (TDS) (see Unicorn vs Hedgehog TDS for Sitecore. Hmm what to choose.).

Files to exclude from Source Control

Many version control tools offer the ability of adding an ignore file to exclude certain files from your source control.

The following list includes files that shouldn’t be included in your source control as they’re included in every Coveo for Sitecore package and can be updated with a new release.

Default Config Files

Typically found under:

Sitecore 7 and 8

  • <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\Coveo\

  • <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\ExperienceAnalyticsCoveo\

  • <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\ExperienceProfileCoveo\

Sitecore 9 and 10

  • <SITECORE_INSTANCE_ROOT>\App_Config\Modules\Coveo\

Default Coveo Layouts, Templates and Renderings

Typically found under:

Sitecore 7 and 8

  • <SITECORE_INSTANCE_ROOT>\Website\Views\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\Website\layouts\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\templates\

Sitecore 9 and 10

  • <SITECORE_INSTANCE_ROOT>\Views\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\layouts\Coveo Hive\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\templates\

Default CSS, JS and Image Files

Typically found under:

Sitecore 7 and 8

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\css\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\js\

  • <SITECORE_INSTANCE_ROOT>\Website\Coveo\Hive\image\

Sitecore 9 and 10

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\css\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\js\

  • <SITECORE_INSTANCE_ROOT>\Coveo\Hive\image\

Any File Containing an Organization ID, Organization Name, API Key, or SearchAPI Key that are Common Between Developers

When a Coveo for Sitecore is activated, the Coveo.CloudPlatformClient.Custom.Config file is created with this information. Don’t include this file in your source control.

Sitecore 7 and 8 The Coveo.CloudPlatformClient.Custom.Config file is created in your <SITECORE_INSTANCE_ROOT>\Website\App_Config\Include\Coveo\ folder.

Sitecore 9 and 10 The Coveo.CloudPlatformClient.Custom.Config file is created in your <SITECORE_INSTANCE_ROOT>\App_Config\Include\Coveo\ folder.

What's Next for Me?