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

Implements the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) [FacetValueSuggestions](https://coveo.github.io/search-ui/components/facetvaluesuggestions.html) which provides query suggestions scoped to distinct categories based on a faceted field (that is, the `Field` data source option value).

Selecting a facet value suggestion from the list of query suggestions triggers a query to the Search API with an [advanced query expression (`aq`)](https://docs.coveo.com/en/175/) which reflects the selected facet value (that is, `@<FIELD> == <SELECTED_FACET_VALUE>`).

## Usage notes

* In the March 2019 and April 2019 releases of Coveo for Sitecore, there's an issue with the ID of the Coveo for Sitecore SXA **{doctitle}** rendering which may cause a Coveo Hive page containing the **{doctitle}** rendering to break (see [SXA Coveo Facet Value Suggestions rendering item overwriting Hive item at installation](https://docs.coveo.com/en/2882/)).
This issue was fixed in the [May 17, 2019 release](https://docs.coveo.com/en/2875#release-notes).

* To get facet value suggestions added to [Coveo Machine Learning](https://docs.coveo.com/en/188/)-powered query completion suggestions, you must first [enable query suggestions](https://docs.coveo.com/en/2797#enabling-query-suggestions) and ensure your search interface generates query suggestions.

* Alternatively, you can have facet value suggestions added to the current content of the search box by enabling the `Use value from search box` option.

* 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 Facet Value Suggestions</strong> rendering is an Allowed Control in the following placeholder(s): <code class="highlighter-rouge">Searchbox Components</code></p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/facet-value-suggestions-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 Facet Value Suggestions</strong> rendering.
  </div>
</div>
<div>
<h3>Coveo Hive SXA</h3>
  <p>When you add the <strong>Coveo Searchbox</strong> SXA rendering, this adds a <code class="highlighter-rouge">coveouisearchboxcomponentssxa</code> placeholder. Insert your <strong>Coveo Facet Value Suggestions</strong> rendering in this <code class="highlighter-rouge">coveouisearchboxcomponentssxa</code> placeholder.</p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/facet-value-suggestions-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 Facet Value Suggestions</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

|Field
|Sitecore field whose values will be used in the facet value suggestions.

|Number of values to display in the suggestions list
|See the [numberOfSuggestions](https://coveo.github.io/search-ui/components/facetvaluesuggestions.html#options.numberofsuggestions) component option.

|Display the estimated number of results
|See the [displayEstimateNumberOfResults](https://coveo.github.io/search-ui/components/facetvaluesuggestions.html#options.displayestimatenumberofresults) component option.

|Use value from search box
|See the [useValueFromSearchbox](https://coveo.github.io/search-ui/components/facetvaluesuggestions.html#options.usevaluefromsearchbox) 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 **FacetValueSuggestions** 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>
  <div id="coveocaf18e11" class="CoveoFacetValueSuggestions" data-prebind-field="fieldTranslator"
  data-field="@manufacturer" data-applied-prebind="true">
  </div>
</div>
```

![Facet value suggestions | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/query-fact-value-suggests-no-number-of-results.gif)