--- title: Coveo for Sitecore 4 to 5 upgrade procedure slug: '2642' canonical_url: https://docs.coveo.com/en/2642/ collection: coveo-for-sitecore-v5 source_format: adoc --- # Coveo for Sitecore 4 to 5 upgrade procedure This article describes the steps to upgrade from Coveo for Sitecore 4 to Coveo for Sitecore 5, depending on your specific use case. To ensure the upgrade goes smoothly, follow the upgrade steps carefully. You should also apply the [leading practices when upgrading Coveo for Sitecore](https://docs.coveo.com/en/2155/) throughout the procedure. > **Leading practice** > > Upgrade to the [latest release of Coveo for Sitecore 5](https://docs.coveo.com/en/2274/). ## Identify your upgrade scenario The recommended upgrade steps to perform depend on the Coveo for Sitecore version and environment you currently have. Select one of the following upgrade scenarios: - Scenario 1: [Upgrading from Coveo for Sitecore 4.0 or 4.1 using Legacy UI components](#scenario-1-from-coveo-for-sitecore-4-0-or-coveo-for-sitecore-4-1-using-legacy-ui-components) - Scenario 2: [Upgrading from a pre-October 2018 release of Coveo for Sitecore 4.1 using Coveo Hive renderings](#scenario-2-from-a-pre-october-2018-release-of-coveo-for-sitecore-4-1-using-coveo-hive-renderings) - Scenario 3: [Upgrading from the October 2018 release or a post-October 2018 release of Coveo for Sitecore 4.1 using Coveo Hive renderings](#scenario-3-from-the-october-2018-release-or-post-october-2018-release-of-coveo-for-sitecore-4-1-using-coveo-hive-renderings) ## Scenario 1: From Coveo for Sitecore 4.0 or Coveo for Sitecore 4.1 using legacy UI components Incrementally upgrading to Coveo for Sitecore 5 would be ineffective and time-consuming. Instead, you should proceed as follows: . Back up your current Coveo-related files. . Delete all Coveo files and folders from your Sitecore instance. . [Download the latest version of Coveo for Sitecore 5](https://docs.coveo.com/en/2274/). . [Install, configure, and activate Coveo for Sitecore 5](https://docs.coveo.com/en/3149/) in your preferred Sitecore deployment scenario. . Follow the instructions specific to your Sitecore deployment scenario to scale Coveo for Sitecore 5 out to the other instances of your Sitecore environment. . [Index your Sitecore content](https://docs.coveo.com/en/3088/). The Coveo [Command Center](https://docs.coveo.com/en/2540/) simplifies this process. . [Build your new search solution](https://docs.coveo.com/en/2473/). ## Scenario 2: From a pre-October 2018 release of Coveo for Sitecore 4.1 using Coveo Hive renderings > **Important** > > To upgrade from one Coveo for Sitecore release to the next, you must perform upgrade steps. > You can access these upgrade steps through [Downloads](https://docs.coveo.com/en/902/) in Coveo for Sitecore 4.1 and [Releases and Downloads](https://docs.coveo.com/en/2274/) in Coveo for Sitecore 5. > Upgrade steps almost always contain a **Manually Update the Coveo Configuration Files** section. > > In the following instructions, updating the configuration means performing the **Manually Update the Coveo Configuration Files** instructions and latter steps from the upgrade steps of a given release, _without_ actually installing the Coveo for Sitecore package itself. > You will only install one Coveo for Sitecore package, the latest release of Coveo for Sitecore 5, at the end of the Coveo for Sitecore 4 to Coveo for Sitecore 5 upgrade procedure. > You will install the latest release of Coveo for Sitecore 5 normally (that is, install the package and perform release upgrade steps). To upgrade to the latest release of Coveo for Sitecore 5 . If not already done, [switch from On-Premises to Cloud indexes](https://docs.coveo.com/en/2514/). . If not already done, [remove any LINQ code querying the Coveo indexes](https://docs.coveo.com/en/2746/). . Incrementally update your Coveo for Sitecore configuration from your current version of Coveo for Sitecore 4.1 to the October 2018 release of Coveo for Sitecore 4.1 (see [Releases](https://docs.coveo.com/en/902/)). . [Update your configuration to the Coveo for Sitecore 5 initial release](https://docs.coveo.com/en/lbnf0387/). . Incrementally update your configuration from the initial release of Coveo for Sitecore 5 to the second to latest release (see [Releases and Downloads](https://docs.coveo.com/en/2274/)). . [Install the latest release](https://docs.coveo.com/en/lbpa0405/) normally. . Perform the [post-upgrade steps](https://docs.coveo.com/en/lbng8192/). . (Recommended) Migrate your search interfaces to a more modern Coveo-powered library. > **Legacy feature** > > The Coveo Hive Framework is now in maintenance mode and is no longer recommended for new implementations. > > To build new search experiences, use one of Coveo's more modern, lightweight, and responsive libraries. > To get started, see the [Build search](https://docs.coveo.com/en/2473/) article. ## Scenario 3: From the October 2018 release or post-October 2018 release of Coveo for Sitecore 4.1 using Coveo Hive renderings > **Important** > > To upgrade from one Coveo for Sitecore release to the next, you must perform upgrade steps. > You can access these upgrade steps through [Downloads](https://docs.coveo.com/en/902/) in Coveo for Sitecore 4.1 and [Releases and Downloads](https://docs.coveo.com/en/2274/) in Coveo for Sitecore 5. > Upgrade steps almost always contain a **Manually Update the Coveo Configuration Files** section. > > In the following instructions, updating the configuration means performing the **Manually Update the Coveo Configuration Files** instructions and latter steps from the upgrade steps of a given release, _without_ actually installing the Coveo for Sitecore package itself. > You will only install one Coveo for Sitecore package, the latest release of Coveo for Sitecore 5, at the end of the Coveo for Sitecore 4 to Coveo for Sitecore 5 upgrade procedure. > You will install the latest release of Coveo for Sitecore 5 normally (that is, install the package and perform release upgrade steps). To upgrade to the latest release of Coveo for Sitecore 5 . If not already done, [switch from On-Premises to Cloud indexes](https://docs.coveo.com/en/2514/). . If not already done, [remove any LINQ code querying the Coveo indexes](https://docs.coveo.com/en/2746/). . [Update your configuration to the Coveo for Sitecore 5 initial release](https://docs.coveo.com/en/lbnf0387/). . Incrementally update your configuration from the initial release of Coveo for Sitecore 5 to the second to latest release (see [Releases and Downloads](https://docs.coveo.com/en/2274/)). . [Install the latest release](https://docs.coveo.com/en/lbpa0405/) normally. . Perform the [post-upgrade steps](https://docs.coveo.com/en/lbng8192/). . (Recommended) Migrate your search interfaces to a more modern Coveo-powered library. > **Legacy feature** > > The Coveo Hive Framework is now in maintenance mode and is no longer recommended for new implementations. > > To build new search experiences, use one of Coveo's more modern, lightweight, and responsive libraries. > To get started, see the [Build search](https://docs.coveo.com/en/2473/) article.