---
title: Coveo Dynamic Facet
slug: '3206'
canonical_url: https://docs.coveo.com/en/3206/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Coveo Dynamic Facet
> **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-943-3.March-26&-2021]
[Coveo for Sitecore 5.0.943.3](https://docs.coveo.com/en/l22b0522#release-notes)


Implements the [Coveo JavaScript Search Framework](https://docs.coveo.com/en/187/) [DynamicFacet](https://coveo.github.io/search-ui/components/dynamicfacet.html) component to display a [facet](https://docs.coveo.com/en/198/).
The **Coveo Dynamic Facet** is an evolution over the [Coveo Facet](https://docs.coveo.com/en/3027/) rendering, particularly because it features [Dynamic Navigation Experience](https://docs.coveo.com/en/3383/).

## Usage notes

* To use the **{doctitle}** rendering, you first need to create a Sitecore field and [index this field as facetable](https://docs.coveo.com/en/2375/).

* To benefit from the automatic facet reordering functionality, group **{doctitle}** renderings and other dynamic facets (for example, [Coveo Dynamic Hierarchical Facets](https://docs.coveo.com/en/3209/) and [Coveo Dynamic Numeric Facet Ranges](https://docs.coveo.com/en/3209/)) within a [Coveo Dynamic Facet Manager](https://docs.coveo.com/en/3207/) (see [Use dynamic facets](https://docs.coveo.com/en/2917/)).

* **{doctitle}** renderings may also be used as standalone facets without a **Coveo Dynamic Facet Manager**.

* Any change to the facet selection triggers a new Search API call.

* You can [display a dynamic facet only when a specific value is selected in another facet](https://docs.coveo.com/en/2788#example-2-display-a-facet-only-when-a-specific-value-is-selected-in-its-parent).

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

|Title
|See the [title](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.title) component option.

|Field
|See the [field](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.field) component option.

|Facet ID
|See the [id](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.id-1) component option.

|Depends on
|The data source `Facet ID` value of another facet that this facet depends on.
See the [dependsOn](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.dependson) component option.

|Enable collapse
|See the [`enableCollapse`](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.enablecollapse) component option.

|Facet collapsed by default
|See the [collapsedByDefault](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.collapsedbydefault) component option.

|Enable search for the facet
|See the [enableFacetSearch](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.enablefacetsearch) component option.

|Enable more/less button
|See the [enableMoreLess](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.enablemoreless) component option.

|Scroll back to the top of the page on interaction
|See the [enableScrollToTop](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.enablescrolltotop) component option.

|Exclude folded result parents
|See the [filterFacetCount](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.filterfacetcount) component option.

|Notify the breadcrumb component
|See the [includeInBreadcrumb](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.includeinbreadcrumb) component option.

|Facet accuracy determined by the number of scanned results
|See the [injectionDepth](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.injectiondepth) component option.

|Number of values
|See the [numberOfValues](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.numberofvalues) component option.

|Sort criterion to use for this facet
|See the [sortCriteria](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.sortcriteria) component option.

a|{empty}
--


[.version.c4sc.c4sc-new.5-0-943-3.March-26&-2021]
[Coveo for Sitecore 5.0.943.3](https://docs.coveo.com/en/l22b0522#release-notes)


--
Custom sort order
|See the [`customSort`](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.customsort) component option.

|Breadcrumb maximum number of selected values
|See the [numberOfValuesInBreadcrumb](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.numberofvaluesinbreadcrumb) component option.

|Prepend facet search queries with a wildcard
|See the [useLeadingWildcardInFacetSearch](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.useleadingwildcardinfacetsearch) component option.

|Mapping of facet values to the desired caption
|See the [`valueCaption`](https://coveo.github.io/search-ui/components/dynamicfacet.html#options.valuecaption) 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 **DynamicFacet** 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 id="coveodb691f100" class="CoveoDynamicFacet" data-title="Total Storage"
data-enable-collapse="true" data-enable-facet-search="true" data-enable-scroll-to-top="true"
data-injection-depth="2147483647" data-number-of-values="5" data-sort-criteria="occurrences"
data-prebind-field="fieldTranslator" data-field="@storage" data-applied-prebind="true">
```

**Visual output is query dependant:**

![output 1](https://docs.coveo.com/en/assets/images/c4sc-v5/dyn-facet-examples.png)