---
title: Insert a Category Facet
slug: '2791'
canonical_url: https://docs.coveo.com/en/2791/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Insert a Category 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-642-2.April-1&-2020]
[Coveo for Sitecore 5.0.642.2](https://docs.coveo.com/en/3204#release-notes)


Your Sitecore items sometimes follow a logical hierarchical structure in the Content Tree.
In such circumstances, you might want to reflect this structure in a search interface facet and allow your website visitors to drill down in the hierarchy.
This article provides you with the instructions on how to insert a **Coveo Category Facet** in a search page.

> **Leading practice**
>
> [.version.c4sc.c4sc-new.5-0-642-2.April-1&-2020]
> [Coveo for Sitecore 5.0.642.2](https://docs.coveo.com/en/3204#release-notes)
> 
> 
> The [Coveo Dynamic Hierarchical Facet](https://docs.coveo.com/en/3209/), which incorporates the [Dynamic Navigation Experience](https://docs.coveo.com/en/3383/) feature, is now recommended over the **Coveo Category Facet**.
> 
> The **Coveo Dynamic Hierarchical Facet** supports the same Sitecore **Content Editor** hierarchical structure and category field value format as the **Coveo Category Facet**.

## Example

You have a ecommerce site with Sitecore product items for each of your catalog products.
These Sitecore items are created in the following folder structure:

![Screenshot of the Sitecore content tree showing an ecommerce folder with nested folders and product items | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/category-facet-content-tree.png)

To create a Coveo Category Facet for these items

. In the Sitecore **Content Editor**, in your product item template, add a `Multi-Line Text` field called `ParentCategories`.

. For the `GE1` product item, created off of the product item template, you would enter the following value in the `ParentCategories` field to list the paths to each of the `GE` item parent folders: `Ecommerce;Ecommerce|Electrical Appliances;Ecommerce|Electrical Appliances|Refrigerators;Ecommerce|Electrical Appliances|Refrigerators|GE`

![Screenshot of the GE1 item selected in the content tree and its Parent Categories field value | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/category-facet-parent-categories-value.png)

> **Note**
>
> The semicolon (;) is the default multi-value separator in Coveo for Sitecore.
> You might have specified another symbol as your multi-value separator in the `Coveo.SearchProvider.Custom.config` file (see [Changing the Separator of Multi-Value Fields](https://docs.coveo.com/en/2377#changing-the-separator-of-multi-value-fields)).

. Publish your changes.

. Configure your `ParentCategories` field as a multi-value facet and rebuild your indexes (see [Configuring a Field as a Multi-Value Facet](https://docs.coveo.com/en/2377#configuring-a-field-as-a-multi-value-facet)).

. In the Sitecore **Experience Editor**, select the **Facets** component.

. Click **Add here** at the position you want to insert your Category Facet.

. In the **Select a Rendering** dialog, select **Coveo Category Facet**.

. In the **Select the Associated Content** dialog, select **Create New Content** to create a new data source for your Coveo Category Facet.

. Select your Coveo Category Facet.

. In the floating toolbar, select **Edit the rendering's data source**.
It should be the leftmost option in the toolbar.

. In the **Basic Settings** section, set values for the following fields:

--
** `Title`: The value in this field becomes the facet caption.

** `Field`: Use the **Select Field** link to select the target Sitecore field you configured as a multi-value facet in the first steps of this procedure.

** `Facet Name`
--

![Screenshot of the Category facet data source with the aforementioned fields populated | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/category-facet-basic-settings.png)

. In the **Navigation** section, set the value of the `FacetBasePath` field to the path of your high-level categories parent folder, relative to the `Home` content tree item.

![Screenshot of the category facet data source with the facet base path field set to ecommerce](https://docs.coveo.com/en/assets/images/c4sc-v5/category-facet-facet-base-path.png)

You're now ready to test your category facet.

![Animated gif showing how the product categories facet values can be expanded to show sub-categories and the number of items they contain](https://docs.coveo.com/en/assets/images/c4sc-v5/category-facet-animation-2.gif)