---
title: Coveo Recommendations
slug: '3042'
canonical_url: https://docs.coveo.com/en/3042/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Coveo Recommendations
> **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.

[.version.c4sc.c4sc-edition.c4sc-new]
[Pro and Enterprise editions^,role=version-tag](https://www.coveo.com/en/pricing/sitecore)


Implements the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) [Recommendation](https://coveo.github.io/search-ui/components/recommendation.html) component to get [content recommendations](https://docs.coveo.com/en/1016/) from the Coveo Machine Learning engine.

## Usage notes

* The **{doctitle}** rendering always acts as a full-fledged search interface and requires a dedicated analytics component (see [Coveo for Sitecore Analytics](https://docs.coveo.com/en/2186/)).

* When bound to a search interface through the `Main search interface` data source option, the **{doctitle}** rendering inherits the [**Sitecore Instance Filter** configurations set on that search interface](https://docs.coveo.com/en/3044/?c4scV5HiveType=tab-hive#data-source-options).

* {empty}

--


[.version.c4sc.c4sc-new.5-0-822-2.October-30&-2020]
[Coveo for Sitecore 5.0.822.2](https://docs.coveo.com/en/3360#release-notes)


--

The [Sitecore Instance Filter](https://docs.coveo.com/en/2192/) rendering is now added automatically with the **{doctitle}** rendering.
This adds the new [`Filter results based on the current Sitecore context database` data source option](#data-source-options) which lets you control whether to add a filter on the current Sitecore context database in the [constant query expression (`cq`)](https://docs.coveo.com/en/179/).
Prior to the October 30, 2020 release, content recommendations were automatically filtered on the current Sitecore context database.

* See [Getting content recommendations](https://docs.coveo.com/en/2303/) for full step-by-step instructions on getting content recommendations in Coveo for Sitecore.

* For leading practices in the implementation of Coveo Content Recommendations, see [Deploy Content Recommendations (CR)](https://docs.coveo.com/en/1886/).

* You can [customize the CSS](https://docs.coveo.com/en/2342/) associated with this rendering.

## Insertion location


<div>
<h3>Coveo Hive</h3>
  <p>The <strong>Coveo Recommendations</strong> rendering is an Allowed Control in the following placeholder(s): <code class="highlighter-rouge">Coveo UI</code>, <code class="highlighter-rouge">Recommendations</code></p>
  <video width="690" height="335" controls="">
<source src="{{ site.baseurl }}/assets/images/c4sc-v5/recommendations-hive.mp4" type="video/mp4" />
Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>Coveo Recommendations</strong> rendering.
  </div>
</div>
<div>
<h3>Coveo Hive SXA</h3>
  <p>Coveo for Sitecore SXA rendering insertion locations aren't limited by placeholder Allowed Controls. The <strong>Coveo Recommendations</strong> rendering may therefore be inserted throughout the partial design, whether in Coveo for Sitecore or Sitecore placeholders.</p>
  <video width="690" height="335" controls="">
<source src="{{ site.baseurl }}/assets/images/c4sc-v5/recommendations-sxa.mp4" type="video/mp4" />
Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>Coveo Recommendations</strong> rendering.
  </div>
</div>

## Data source options

The following table lists the available data source options for this rendering.

[%header,cols="33%,66%"]
|===
|Option name
|Description

|Title
|The text to show in the header.

|Results per page
|See the [resultsPerPage](https://coveo.github.io/search-ui/components/searchinterface.html#options.resultsperpage) component option.

|Hide if no results
|See the [hideIfNoResults](https://coveo.github.io/search-ui/components/recommendation.html#options.hideifnoresults) component option.

|Main search interface
|See the [mainSearchInterface](https://coveo.github.io/search-ui/components/recommendation.html#options.mainsearchinterface) component option.
If left empty, the rendering acts as a standalone search interface.

a|{empty}
--


[.version.c4sc.c4sc-new.5-0-822-2.October-30&-2020]
[Coveo for Sitecore 5.0.822.2](https://docs.coveo.com/en/3360#release-notes)


--
Filter results based on the current Sitecore context database
|See the [Sitecore Instance Filter](https://docs.coveo.com/en/2192/?c4scV5HiveType=tab-hive#data-source-options) rendering data source options.

|Filter results on the current context language
|See the [Sitecore Instance Filter](https://docs.coveo.com/en/2192/?c4scV5HiveType=tab-hive#data-source-options) rendering data source options.

|Filter results on the latest version
|See the [Sitecore Instance Filter](https://docs.coveo.com/en/2192/?c4scV5HiveType=tab-hive#data-source-options) rendering data source options.

|Query pipeline
|See the [pipeline](https://coveo.github.io/search-ui/components/searchinterface.html#options.pipeline) component option.

|Maximum age
|See the [maximumAge](https://coveo.github.io/search-ui/components/searchinterface.html#options.maximumage) component option.

|DOM unique ID
a|{empty}
--
Randomly generated HTML element ID.
--

|Additional data attributes
a|{empty}
--
Allows [use of the Coveo JavaScript Search Framework **Recommendation** component options](https://docs.coveo.com/en/2776/) that aren't directly available in the data source.
--
|===

## Sample generated HTML and corresponding visual output

```html
<div id="coveof3fa2f49" class="CoveoRecommendation CoveoSearchInterface Coveostate
CoveoComponentState CoveoComponentOptions CoveoQueryController CoveoDebug coveo-after-initialization"
data-results-per-page="3" data-prebind-maximum-age="currentMaximumAge"
data-pipeline="recommendations" data-title="Recommendations"
data-prebind-main-search-interface="mainSearchInterfaceSelector"
data-main-search-interface="#coveo20ee610d" data-applied-prebind="true" data-maximum-age="0"
style="" data-coveo-for-sitecore-event-registered="true">
```

![Recommendation Rendering Example | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/recommendations-example.png)