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

![Coveo for Sitecore Specific Rendering](c4sc-v5/sitecore-20-px-new.png)
This rendering adds [external sources](https://docs.coveo.com/en/3193/) from your [Coveo organization](https://docs.coveo.com/en/185/) to the query by altering the [constant query expression (`cq`)](https://docs.coveo.com/en/179/) of search API calls (see [About the query expression](https://docs.coveo.com/en/2830/)).

It registers a handler in the `onBuildingSitecoreExternalContent` event triggered by the [CoveoForSitecoreExpressions](https://docs.coveo.com/en/2189/) component.

## Usage notes

* The **{doctitle}** rendering is added automatically with the **Coveo Search Interface** and **Coveo Tab** renderings.

* When external content sources are specified in a **Coveo Search Interface** data source, items from the specified sources are returned in search results, regardless of the selected search interface tab.
When specified in a **Coveo Tab** data source, items from the specified sources are returned in search results when that tab is selected.

* {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)


--
When the [Sitecore Instance Filter](https://docs.coveo.com/en/2192/) `Filter results based on the current Sitecore context database` option is disabled, items from all your Coveo organization sources are included in search results, unless you explicitly specify target sources in the **{doctitle}** rendering.

## Insertion location


<div>
<h3>Coveo Hive</h3>
  <p>The <strong>External Content</strong> rendering is an Allowed Control in the following placeholder(s): <code class="highlighter-rouge">UI Header</code>, <code class="highlighter-rouge">Recommendations Components</code>, <code class="highlighter-rouge">Searchbox Components</code></p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/external-content-hive.mp4" type="video/mp4" />
  Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>External Content</strong> rendering.
  </div>
</div>
<div>
<h3>Coveo Hive SXA</h3>
  <p>The Coveo for Sitecore SXA <strong>External Content</strong> rendering is meant to be inserted in specific placeholders (that is, <code class="highlighter-rouge">UI Header</code>, <code class="highlighter-rouge">Recommendations Components</code>, <code class="highlighter-rouge">Searchbox Components</code>).</p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/external-content-sxa.mp4" type="video/mp4" />
  Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>External Content</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

|Names of external content sources
|The names of the Coveo organization external sources to search through on top of the Coveo source associated with the current Sitecore context database.
Source names may be found in the [**Sources**](https://platform.cloud.coveo.com/admin/#/orgid/content/sources/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/sources/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/sources/)) page.
For multiple external sources, use a comma between your source names or list the sources on separate lines.
|===

## Sample Generated HTML and Corresponding Query Expressions

In the example below, two external sources were added in the `Names of external content sources` field of a **Coveo Tab** rendering data source.

**Generated HTML:**

```html
<span class="CoveoForSitecoreExternalContent" data-sc-scope-to-tab="coveod9c70725"
data-sc-sources="techzample site,coveo docs">
</span>
```

**Search API call `cq`:**

![External content cq | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/external-content-api-call-aq-cq.png)