---
title: December 21, 2018 release (5.0.140.19)
slug: '2682'
canonical_url: https://docs.coveo.com/en/2682/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# December 21, 2018 release (5.0.140.19)
> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485/), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274/).
> 
> 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#multi-release-upgrade) of Coveo for Sitecore.
> 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#multi-release-upgrade) of Coveo for Sitecore.


<p>This release includes the 2.4710.8 version of the JavaScript Search Framework (see <a href="{{ site.baseurl }}/410/">October 2018 Release (v2.4710.8)</a>).</p>
<p>When using a CDN with the Coveo Hive framework, this release includes the latest 2.4710 version of the JavaScript Search Framework (see <a href="{{ site.baseurl }}/2629/">Choosing between local and CDN Coveo JavaScript resource files</a>).</p>

<h2 id="release-notes">Release Notes</h2>
<p>This section summarizes the new features and fixed support cases introduced in the Coveo for Sitecore December 21, 2018 release (5.0.140.19).</p>
<div class="table-wrap table-header-nowrap">
  <table>
    <thead>
      <tr>
        <th>Identifier</th>
        <th>Enhancement</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>SC-1564</td>
        <td>In a Coveo-powered search page, either published or in the Experience Editor, output the current version of Coveo for Sitecore when <code class="highlighter-rouge">CoveoForSitecore.version</code> is typed in browser developer tools console.</td>
      </tr>
      <tr>
        <td>SC-2134</td>
        <td>Issue a warning in the web browser developer tools when no analytics component is present on the search page.</td>
      </tr>
      <tr>
        <td>SC-3231</td>
        <td>Change the display name of the <code class="highlighter-rouge">Coveo Analytics</code> rendering in the <strong>Content Editor</strong> and issue a warning in the <strong>Experience Editor</strong> to indicate this component is deprecated.</td>
      </tr>
    </tbody>
  </table>
</div>
<div class="table-wrap table-header-nowrap">
  <table>
    <thead>
      <tr>
        <th>Identifier</th>
        <th>Bug fix</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>SC-3112</td>
        <td>Removed the legacy Security Provider upgrade utilities.</td>
      </tr>
      <tr>
        <td>SC-3439</td>
        <td>Fixed issue with <code class="highlighter-rouge">Send Analytics to Sitecore</code> component calls returning internal server errors.</td>
      </tr>
      <tr>
        <td>SC-3447</td>
        <td>Fixed issue with various links redirecting to Coveo for Sitecore 4 documentation pages.</td>
      </tr>
    </tbody>
  </table>
</div>
<h2 id="upgrade-steps">Upgrade Steps</h2>

> **Important**
>
> Per the Coveo [Version Support Lifecycle policy](https://docs.coveo.com/en/1485/), this Coveo for Sitecore 5 release has reached end of support.
> See [available Coveo for Sitecore releases](https://docs.coveo.com/en/2274/).
> 
> 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#multi-release-upgrade) of Coveo for Sitecore.
> 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#multi-release-upgrade) of Coveo for Sitecore.


<p>This section describes how to upgrade Coveo for Sitecore from November 23, 2018 (5.0.74.10) to December 21, 2018 (5.0.140.19). If you're upgrading over multiple versions, Coveo has a <a href="{{ site.baseurl }}/2155#multi-release-upgrade">procedure</a> to streamline the process.</p>

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


<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.


<ol>
  <li>
    <p>Log in to the Sitecore Desktop.</p>
  </li>
  <li>
    <p>Access the Installation Wizard (<strong>Sitecore Start Menu</strong> &gt; <strong>Development Tools</strong> &gt; <strong>Installation Wizard</strong>).</p>
  </li>
  <li>
    <p>Upload and install the <code class="highlighter-rouge">Coveo for Sitecore XX 5.0.140.19</code> package.</p>
  </li>
  <li>
    <p>When prompted to overwrite files, click <strong>Yes to all</strong>.</p>
  </li>
  <li>
    <p>When prompted to overwrite items, select <strong>Overwrite</strong>, then click <strong>Apply to all</strong>.</p>

> **Note**
>
> You might be prompted twice with this question.
> Select the **Overwrite** option and click **Apply to all** both times.


  </li>
  <li>
    <p>Once the installation is completed, make sure that you restart both the Sitecore client and server.</p>
    <p><img src="{{ site.baseurl }}/assets/images/c4sc-v5/35455209.png" alt="Install a Package dialog showing successful Coveo package installation and instructions to restart Sitecore client and server" class="border" /></p>
  </li>
</ol>
<h3 id="step-2-replace-the-coveo-analytics-component-with-the-coveo-for-sitecore-analytics-component">Step 2: Replace the Coveo Analytics Component With the Coveo for Sitecore Analytics Component</h3>
<p>The <strong>Coveo Analytics</strong> component has been deprecated. If you're using this component in your Coveo-powered search interface(s), we recommend you use the <strong>Coveo for Sitecore Analytics</strong> component instead.</p>
<h3 id="step-3-update-your-onsitecorecontextinitialization-event-handler-code">Step 3: Update Your <code class="highlighter-rouge">onSitecoreContextInitialization</code> Event Handler Code</h3>
<p>The arguments passed to the JavaScript <code class="highlighter-rouge">onSitecoreContextInitialization</code> event of Coveo Hive now pass the <code class="highlighter-rouge">isInExperienceEditor</code> attribute instead of <code class="highlighter-rouge">isEditing</code>.</p>
<p>If you have registered handlers on the <code class="highlighter-rouge">onSitecoreContextInitialization</code> event, ensure that you use the <code class="highlighter-rouge">isInExperienceEditor</code> attribute of the <code class="highlighter-rouge">ISitecoreContextInitializationEventArgs</code> object from now on.</p>

**Example**

You had an event handler such as the following in your code:

[source,c#]
```
Coveo.$$(searchInterfaceElement).on("onSitecoreContextInitialization", function(event, args) {
   if (args.isEditing) {
       // ...
   }
});
```

You would need to update it as follows:

[source,c#]
```
Coveo.$$(searchInterfaceElement).on("onSitecoreContextInitialization", function(event, args) {
   if (args.isInExperienceEditor) {
       // ...
   }
});
```


<h3 id="step-4-publish-your-site">Step 4: Publish your site</h3>
<p>In the Sitecore <strong>Content Editor</strong>, perform a publish site action. This ensures any changes related to Coveo components in the upgrade are published to the <code class="highlighter-rouge">web</code> database.</p>

---
[&#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/lbng8192/)
[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/2722#step-2-manually-update-the-coveo-configuration-files)

{nbsp}  
{nbsp}  
{nbsp}