---
title: September 18, 2020 release (5.0.788.5)
slug: '3314'
canonical_url: https://docs.coveo.com/en/3314/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# September 18, 2020 release (5.0.788.5)

> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485.md), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274.md).
> 
> Even if this release is no longer supported, you must still perform some of its [upgrade steps](#upgrade-steps) to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.

This release includes the 2.9159.8 version of the JavaScript Search Framework (see [June 2020 Release (v2.9159)](https://docs.coveo.com/en/3273/)).

When using a CDN with the Coveo Hive Framework, this release includes the latest 2.9159 version of the JavaScript Search Framework (see [Choosing between local and CDN Coveo JavaScript resource files](https://docs.coveo.com/en/2629.md)).

<h2 id="release-notes">Release Notes</h2>

This section summarizes the new features and fixed support cases introduced in the Coveo for Sitecore September 18, 2020 release (5.0.788.5).

<div class="table-wrap table-header-nowrap">
  
| Identifier | Enhancement |
|---|---|
| SC-4086 | Expose the `expression` property for the **Coveo JavaScript Search Framework FacetValueSuggestions** component data source. |
| SC-4497 | Added support for the Coveo JavaScript Search Framework **SortDropdown** component. |
| SC-4509 | Added support for new usage analytics endpoint. |
| SC-4543 | Provided ability to connect a Sitecore instance to Coveo organizations across all available data residency regions. |
| SC-4544 | Added support for SXA 10.0. |
| SC-4554 | Added support for Sitecore 10.0. |

</div>
<div class="table-wrap table-header-nowrap">
  
| Identifier | Case | Fixed Support Case |
|---|---|---|
| SC-4551 | 00062150 | Fixed issue with Sitecore returning 127.0.0.1 as the server URL on Azure. |

</div>
<div class="table-wrap table-header-nowrap">
  
| Identifier | Bug Fix |
|---|---|
| SC-4542 | Enable license parameters `queryQuotaPerOrgLimit` and `querySuggestQuotaPerOrgLimit` to be used instead of `queryRateLimit`. |

</div>
<h2 id="upgrade-steps">Upgrade Steps</h2>

> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485.md), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274.md).
> 
> Even if this release is no longer supported, you must still perform some of its upgrade steps to [upgrade to a more recent version](https://docs.coveo.com/en/2155.md#multi-release-upgrade) of Coveo for Sitecore.

This section describes how to upgrade Coveo for Sitecore from August 10, 2020 (5.0.761.5) to September 18, 2020 (5.0.788.5). If you're upgrading over multiple versions, Coveo has a [procedure](https://docs.coveo.com/en/2155.md#multi-release-upgrade) to streamline the process.

> **Important**
>
> For the best Coveo for Sitecore experience, always follow the [upgrading leading practices](https://docs.coveo.com/en/2155.md).

<h3 id="step-1-upgrade-coveo-for-sitecore">Step 1: Upgrade Coveo for Sitecore</h3>

> **Important**
>
> Make sure the Microsoft MVC security update [MS14-059](https://docs.microsoft.com/en-us/security-updates/SecurityBulletins/2014/ms14-059) is installed on every Sitecore host in your environment.

  - Log into the Sitecore Desktop.
  - Access the Installation Wizard (**Sitecore Start Menu** &gt; **Development Tools** &gt; **Installation Wizard**).
  - Upload and install the Coveo for Sitecore 5.0.788.5 package built for the specific version of Sitecore you're running.
  - When prompted to overwrite files, click **Yes to all**.
  - When prompted to overwrite items, select **Overwrite**, then click **Apply to all**.

> **Note**
>
> You might be prompted twice with this question.
> Select the **Overwrite** option and click **Apply to all** both times.
  - Once the installation is completed, make sure that you restart both the Sitecore client and server.

<h3 id="step-2-manually-update-the-coveo-configuration-files">Step 2: Manually Update the Coveo Configuration Files</h3>

The Coveo configuration files are located in the `App_Config\Include\Coveo` folder. When upgrading, you must compare the changes to the `.example` files from your current Coveo for Sitecore version with the ones in the build you're upgrading to. Then, you can merge these changes into your current configuration files. This method let's you keep your customization intact, while still benefiting from the latest enhancements brought in the product. You can use a merge tool such as [WinMerge](http://winmerge.org/) to do this.

In further detail, here are the modifications that you must perform to the configuration files resulting from the feature changes between the previous and current Coveo for Sitecore releases:

<h4 id="coveosearchproviderrestconfig">Coveo.SearchProvider.Rest.config</h4>

The `&lt;analyticsUri&gt;` element text node has changed. The new value is `https://platform.cloud.coveo.com/rest/ua`. Update this setting, both in `Coveo.SearchProvider.Rest.config` and in the `Coveo.SearchProvider.Rest.Custom.config` patch file, to ensure the final configuration uses the new endpoint.

<h4 id="coveoserviceapiindexserviceconfig-and-coveoserviceapiconfigserviceconfig">Coveo.Service.Api.IndexService.config and Coveo.Service.Api.ConfigService.config</h4>

Setting a cache expiration for storing organizations using the `&lt;fetchOrganizations&gt;` element has been moved from the `Coveo.Service.Api.IndexService.config` file to the `Coveo.Service.Api.ConfigService.config` file.

If you had manually changed the `&lt;fetchOrganizations&gt;` element value in `Coveo.Service.Api.IndexService.config`, ensure you set  `&lt;fetchOrganizations&gt;` in `Coveo.Service.Api.ConfigService.config` to the same value.

<h3 id="step-3-optional-use-queryquotaperorglimit-instead-of-queryratelimit-to-configure-the-query-rate-limit">Step 3: (Optional) Use queryQuotaPerOrgLimit Instead of queryRateLimit to Configure the Query Rate Limit</h3>

If you added the `queryRateLimit` parameter to your `Coveo.SearchProvider.Rest.Custom.config` file to [configure the query rate limit](https://docs.coveo.com/en/2179.md), you should replace it with `queryQuotaPerOrgLimit`.

<h3 id="step-4-end-use-of-urloptions-and-mediaurloptions-properties-in-custom-code">Step 4: End Use of `UrlOptions` and `MediaUrlOptions` Properties in Custom Code</h3>

The `UrlOptions` and `MediaUrlOptions` properties of the `Coveo.Framework.Links.IUrlOptions` and `Coveo.Framework.Links.IMediaUrlOptions` classes respectively have been marked as obsolete. Adjust your custom code if necessary.

<h3 id="step-5-publish-your-site">Step 5: Publish your site</h3>

In the Sitecore **Content Editor**, perform a publish site action. This ensures any changes related to Coveo components in the upgrade are published to the `web` database.

---
[&#9001;{nbsp}{nbsp}Previous version upgrade steps,role="float-start btn home-outline-btn d-inline-flex px-150 mt-100"](https://docs.coveo.com/en/3279.md#step-2-publish-your-site)
[Next version upgrade steps{nbsp}{nbsp}&#9002;,role="float-end btn home-outline-btn d-inline-flex px-150 mt-100"](https://docs.coveo.com/en/3360.md#step-2-manually-update-the-coveo-configuration-files)

{nbsp}  
{nbsp}  
{nbsp}