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

--
![Preferences Menu Option | Coveo for Sitecore 5](c4sc-v5/preferences-menu-option.png)
Implements the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) [PreferencesPanel](https://coveo.github.io/search-ui/components/preferencespanel.html) component which renders a **Preferences** item in the [Settings popup menu](https://coveo.github.io/search-ui/components/settings.html).

When website visitors select the **Preferences** option, a modal is displayed allowing them to specify and save search interface customization options (see [Coveo Results Preferences](https://docs.coveo.com/en/3060/)).
--

## Usage notes

* The Coveo for Sitecore implementation adds a `Preferences Panel` placeholder, accessible through the Settings popup menu, in which you can insert preferences renderings, such as the [Coveo Results Preferences](https://docs.coveo.com/en/3060/) rendering.

* Coveo for Sitecore currently only supports the [ResultsPreferences](https://coveo.github.io/search-ui/components/resultspreferences.html) Coveo JavaScript Search Framework component.
The [ResultsFiltersPreferences](https://coveo.github.io/search-ui/components/resultsfilterspreferences.html) component isn't supported.

## Insertion location


<div>
<h3>Coveo Hive</h3>
  <p>The <strong>Coveo Preferences Panel</strong> rendering is an Allowed Control in the following placeholder(s): <code class="highlighter-rouge">Searchbox Options</code></p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/preferences-panel-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 Preferences Panel</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 Preferences Panel</strong> rendering may therefore be inserted throughout the partial design, whether in Coveo for Sitecore or Sitecore placeholders.</p>
  <p>To ease rendering management, group <strong>Coveo Advanced Search</strong>, <strong>Coveo Export To Excel</strong>, <strong>Coveo Preferences Panel</strong> and <strong>Coveo Share Query</strong> renderings together near your <strong>Coveo Settings Button</strong> rendering.</p>
  <video width="690" height="335" controls="">
  <source src="{{ site.baseurl }}/assets/images/c4sc-v5/preferences-panel-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 Preferences Panel</strong> rendering.
  </div>
</div>

## Data source options

The following table lists the available data source options for this rendering.

This rendering has no data source.

## Sample generated HTML and corresponding visual output

**Generated HTML**:

```html
<div class="CoveoPreferencesPanel">
  <div>
    <div class="CoveoResultsPreferences">
      <!-- code of the Coveo Results Preferences rendering appears here -->
   </div>
  </div>
</div>
```

When a website visitor selects the **Preferences** option in the Settings popup menu, a modal like the one below is displayed.

![Preferences Panel Sample | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/preferences-panel-sample.png)