---
title: Coveo Commerce Query
slug: '3291'
canonical_url: https://docs.coveo.com/en/3291/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Coveo Commerce Query
> **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-new.5-0-761-5.August-10&-2020]
[Coveo for Sitecore 5.0.761.5](https://docs.coveo.com/en/3279#release-notes)


Implements the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) [CommerceQuery](https://coveo.github.io/search-ui/components/commercequery.html) component, which sets the `originLevel2` and the `customData[context_listing]` values in the call to the [Coveo Usage Analytics service](https://docs.coveo.com/en/l3bf0598/).

## Usage notes

* The **Coveo for Sitecore Analytics** rendering must be added to the page.
The **{doctitle}** rendering only alters the search analytics call generated by the **Coveo for Sitecore Analytics** rendering.

## Insertion location


<div>
<h3>Coveo Hive</h3>
  <p>The <strong>Coveo Commerce Query</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></p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/commerce-query-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 Commerce Query</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 Commerce Query</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/commerce-query-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 Commerce Query</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

|Commerce query listing
|See the [listing](https://coveo.github.io/search-ui/components/commercequery.html#options.listing) component option.

|Additional data attributes
a|{empty}
--
Allows [use of the Coveo JavaScript Search Framework **CommerceQuery** 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 class="CoveoCommerceQuery" data-listing="ACME Furniture"></div>
```

**Sample call to the analytics proxy endpoint**:

![Commerce Query Sample Usage Analytics Call | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/commerce-query-sample-ua-call.png)