---
title: Sitecore Instance Filter
slug: '2192'
canonical_url: https://docs.coveo.com/en/2192/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Sitecore Instance Filter
> **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)
Implements the **CoveoForSitecoreLocalExpression** component which adds filters for the current Sitecore instance to the [constant query expression (`cq`)](https://docs.coveo.com/en/179/) of Search API calls.

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


[.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 new `Filter results based on the current Sitecore context database` option lets you control whether to add a filter on the current Sitecore context database in the `cq`.
Prior to the October 30, 2020 release, search results and recommendations were automatically filtered on the current Sitecore context database using a `source==<SITECORE_SOURCE_NAME>` filter in the [advanced query expression (`aq`)](https://docs.coveo.com/en/175/).

## Usage notes

* The **{doctitle}** rendering is added automatically with the [Coveo Search Interface](https://docs.coveo.com/en/3044/) rendering.

* {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 **{doctitle}** rendering is now added automatically with the [Coveo Recommendations](https://docs.coveo.com/en/3042/) and [Coveo Related Query](https://docs.coveo.com/en/3043/) renderings.

## Insertion location


<div>
<h3>Coveo Hive</h3>
  <p>The <strong>Sitecore Instance Filter</strong> rendering is an Allowed Control in the following placeholder(s): <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/sitecore-instance-filter-hive.mp4" type="video/mp4" />
  Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>Sitecore Instance Filter</strong> rendering.
  </div>
</div>
<div>
<h3>Coveo Hive SXA</h3>
  <p>The Coveo for Sitecore SXA <strong>Sitecore Instance Filter</strong> rendering is meant to be inserted in specific placeholders (that is, <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/sitecore-instance-filter-sxa.mp4" type="video/mp4" />
  Your browser doesn't support the video tag.
</video>
  <div class="figure-caption">Example insertion sequence for the <strong>Sitecore Instance Filter</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

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
|Defines whether to include a filter such that only items from the current Sitecore context database will be included in query results or recommendations.
Disabling this option automatically disables the other Sitecore-specific filters below.

|Filter Sitecore results on the current context language
|Defines whether to include only Sitecore items in the current context language in query results or recommendations.

|Filter Sitecore results on the latest version
|Defines whether to include only the latest version of Sitecore items in each language in query results or recommendations.
|===

## Sample Generated HTML and Corresponding Results

```html
<div class="CoveoForSitecoreLocalExpression"
data-sc-filter-on-sitecore-context-database="true"
data-sc-filter-on-current-language="false"
data-sc-filter-on-latest-version="true">
</div>
```

**Search API call `cq`:**

![Sitecore instance filter cq value | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/sitecore-instance-filter-sample-cq.png)

**Query Results:**

![Sitecore instance filter sample results | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/sitecore-instance-filter-sample-output-results.png)