---
title: Query Suggestions
slug: '2797'
canonical_url: https://docs.coveo.com/en/2797/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Query Suggestions
> **Legacy feature**
>
> This article pertains to achieving relevance with the Coveo Hive framework.
> Coveo Hive is now in maintenance mode.
> 
> See [Achieve relevance](https://docs.coveo.com/en/n9qd0318/) for guidance on leveraging [Coveo Platform](https://docs.coveo.com/en/186/) relevance features with the Coveo Atomic library.

The [Query Suggestion (QS)](https://docs.coveo.com/en/1015/) feature leverages [Coveo Analytics](https://docs.coveo.com/en/182/) to propose [queries](https://docs.coveo.com/en/231/) to users as they type in the search box.
Clicking a suggestion completes the query and sends it to the [index](https://docs.coveo.com/en/204/).

![Screenshot of a searchbox with part of the word insight typed and the searchbox suggesting different queries with insight or index or interface in them](https://docs.coveo.com/en/assets/images/c4sc-v5/query-suggestions.png)

> **Note**
>
> When the QS feature is enabled, Coveo for Sitecore doesn't generate any queries against your index while the user is typing.
> Therefore, this feature doesn't impact your query per month usage.

## How the Suggested Queries are Determined

The relevance score of each query suggestion is determined by the following:

* The query frequency.
* The degree to which the query suggestion matches the typed characters.
* The query performance.

To summarize, in order to get relevant query suggestions, you need queries and clicks on query results (see [About Query Suggestions](https://docs.coveo.com/en/3386/)).

> **Important**
>
> A [minimum amount of usage analytics data needs to be collected](https://docs.coveo.com/en/2010/) before the **Coveo Searchbox** component begins suggesting queries.

> **Note**
>
> You can use the [Coveo UA bot](https://github.com/coveooss/uabot) to batch simulate visits, queries, and clicks on a site.

## Enabling Query Suggestions

When you include the **Coveo Searchbox** rendering in a Coveo for Sitecore search interface, the **Enable Coveo Machine Learning query suggestions** option in the data source is set to use the default `enableQuerySuggestAddon` setting of the Coveo JavaScript Search Framework [Omnibox component](https://coveo.github.io/search-ui/components/omnibox.html).
Since that default value is `true`, you should have nothing to do to enable the feature from a rendering configuration standpoint.

![Screenshot of the Coveo Searchbox rendering data source showing all suggestion add-ons options set to use default | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/search-box-query-suggestions-enabled.png)

However, a [Coveo Machine Learning (Coveo ML)](https://docs.coveo.com/en/188/) QS model has to be created and configured.

To enable QS in your search interface

. Open your search page in the Sitecore **Experience Editor**.
. [Add a Coveo Searchbox component](https://docs.coveo.com/en/2505#add-a-search-box-component) to your interface, if not already done.
. Add the **Coveo for Sitecore Analytics** component to your search interface, if not already done.
 .. Locate and select the **UI Header** placeholder.

![Screenshot of the Sitecore Experience Editor showing the ui header rendering and its Add here placeholder button | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/ui-header-placeholder.png)

 .. Click **Add here**.
 .. Select the **Coveo for Sitecore Analytics** component and click **Select**.

![Screenshot of the Sitecore Select a Rendering window with the selected placeholder allowed controls displayed and the Coveo for Sitecore Analytics rendering selected](https://docs.coveo.com/en/assets/images/c4sc-v5/coveo-for-sitecore-analytics-selection.png)

 .. Create or select a data source for your **Coveo for Sitecore Analytics** component.
. Save and publish your search page.
. In the Coveo Administration Console, [create a QS machine learning model](https://docs.coveo.com/en/3398/).
. Collect enough usage analytics data for the search box to begin suggesting queries (see [Prerequisites](https://docs.coveo.com/en/3398#prerequisites)).