---
title: Facet manager
slug: p3oa0420
canonical_url: https://docs.coveo.com/en/p3oa0420/
collection: coveo-merchandising-hub
source_format: adoc
---
# Facet manager

The **Facet manager** is part of the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) and allows merchandisers to manage all the [facet fields](https://docs.coveo.com/en/p9pn0467/) and [facet collections](https://docs.coveo.com/en/p5890502/) for their Coveo-powered [storefronts](https://docs.coveo.com/en/p33g0410/) from one convenient location.
With this tool, merchandisers can manage how [facets](https://docs.coveo.com/en/198/) are displayed to visitors on product listing and search results pages.

All changes made in the **Facet manager** are instantly reflected in the **Facet tabs** of the Search manager and the Product listing manager.
The changes are also automatically applied to storefronts without requiring any additional steps.

> **Note**
>
> For general information on facets, consult the section [The more you know: All about facets](#the-more-you-know-all-about-facets).

## Prerequisites

To successfully use this feature, your [Coveo organization](https://docs.coveo.com/en/185/) must:

* Have the **Facet** or **Multi-value facet** option enabled on the [**Fields**](https://platform.cloud.coveo.com/admin/#/orgid/content/fields/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/fields/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/fields/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/fields/)) page for every field intended to be used as a facet.
For a facet to be used as a relevance-based facet, the following options must also be selected:

** The **Facet Generator** option.

** The **Search operator** option.
Activating this option requires that the source be rebuilt in order for the changes to take effect.

* Have a compatible version of Headless.
We recommend version 3.24.1 or later.

## Facet manager main page

The **Facet manager** main page is accessed through the CMH interface and provides merchandisers with an overview of all configured [facet collections](https://docs.coveo.com/en/p5890502/) and [facet fields](https://docs.coveo.com/en/p9pn0467/) for a specific property.

![Anatomy of the Facet manager | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facet-manager-main.png)

[cols="1,5"]
|===
|1
|The **Property** selector lets merchandisers select the [property](https://docs.coveo.com/en/p4ue0547/) used to scope the facet collections and fields displayed in the Facet manager. See [**Property and locale selectors**](https://docs.coveo.com/en/o6lb0453#property-and-locale-selectors) for more information about [properties](https://docs.coveo.com/en/p4ue0547/).

|2
|The search bar lets merchandisers search for existing facets using their [facet field](https://docs.coveo.com/en/p9pn0467/) name.

|3
|The **Facet collections** tab lets merchandisers access all the configured [facet collections](https://docs.coveo.com/en/p5890502/) for the selected [property](https://docs.coveo.com/en/p4ue0547/).

|4
|The **All facet fields** tab lets merchandisers view a list of all the [facet fields](https://docs.coveo.com/en/p9pn0467/) available for the selected [property](https://docs.coveo.com/en/p4ue0547/).

|5
|The **Performance** tab lets merchandisers view [facet engagement](https://docs.coveo.com/en/q1sa0327/) for the selected [property](https://docs.coveo.com/en/p4ue0547/).
|===

## Facet collections tab

The **[facet collections](https://docs.coveo.com/en/p5890502/)** tab provides merchandisers with a list of all the [facet collections](https://docs.coveo.com/en/p5890502/) for both the search result pages and product listing pages.
From this tab, merchandisers can:

* Create new facet collections.

* Modify existing facet collections.

* Delete facet collections.

> **Important**
>
> It's important that all languages within a facet field are assigned a display name, especially when using [relevance-based](https://docs.coveo.com/en/p3oa0420#facets-selected-by-relevance) facets.
> 
> Example: The facet field `prod_cat_color` would appear as such on the storefront if a display name wasn't assigned.

![Facet manager Collections tab | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facet-manager-collections.png)

[cols="1,5"]
|===
|1
|The **Create facet collection** button lets merchandisers create new [facet collections](https://docs.coveo.com/en/p5890502/).
They can create a default facet collection for **Search** or for **Listing pages** if none exist, or can create customized collections for specific listing pages.

|2
|The **Facets in search** section displays the default facet collection that's currently applied to all search result pages.
Merchandisers can use the **Modify** button to modify or delete the facet collection.

|3
|The **Facets in listing pages** section displays the default facet collection that's initially applied to product listing pages.
The default facet collection is replaced once a specific facet collection is assigned to a product listing page.
Merchandisers can use the **Modify** button to modify or delete the facet collection.

|4
|The **Listing pages** section displays all the product listing pages that have facet collections attributed to them.
Merchandisers can use the **Modify** button to modify or delete the facet collection.
|===

### Create a facet collection

To create a [facet collection](https://docs.coveo.com/en/p5890502/) from within the **Facet** manager:

. Click **Create facet collection**.

** Select the target for the facet collection.
Unavailable targets will be grayed out.

** If you want to create the **Default** facet collection, click **Default**.

** If you want to create a facet collection for a specific product listing page, select **Specific**.
You'll then be prompted to select the product listing page for which the facet collection will apply.

. Select the [facet fields](https://docs.coveo.com/en/p9pn0467/) that you want to pin and click **Add selected**.
You can pin up to 30 facet fields.
These facet fields will always be pinned on top of the facet section.
See [manually pinned facets](https://docs.coveo.com/en/p3oa0420#manually-pinned-facets) for more information.

. Once all the facets you want to pin are selected, click **Next: order and settings**.

. On the **Facets order and settings** page, you can:

** Set the order of pinned facets.
This determines the order in which pinned facets should appear in the facet section.

** Enable the **Facets selected by relevance** option.
This lets you define dynamic spots that will be filled by Coveo with the most relevant facets based on the visitor's query.
See [Facets selected by relevance](https://docs.coveo.com/en/p3oa0420#facets-selected-by-relevance) for more information.

** Click **Modify** next to a pinned facet to edit its settings.


> **Important**
>
> When a facet field's settings are modified, the changes are applied throughout the selected [property](https://docs.coveo.com/en/p4ue0547/).

*** On the **Facet** tab of the editor:

**** Under **Displayed name**, enter the facet title as it should be displayed to visitors for each available language.

**** From the **Facet type** dropdown menu, you can update the default [facet type](https://docs.coveo.com/en/p3oa0420#facet-types) (if applicable).

**** Under **Selection options**, choose whether the facet should be a single or multi-select facet.

**** Under **Facet default state**, choose whether the facet values for this facet should be open or closed by default.

*** On the **Values** tab of the editor:

**** Under **Values sorting**, choose the type of [value sorting](https://docs.coveo.com/en/p3oa0420#facet-values-sorting-methods) that should be applied to the facet values.

**** Under **Number of values shown**, enter the number of values displayed before a visitor needs to select **Show more** on the facet to see more values.
The default is `100`, and the maximum is `1000` facet values.

. Click **Publish now**.

### Modify a facet collection

To edit an existing [facet collection](https://docs.coveo.com/en/p5890502/) from within the **Facet** manager:

. Locate the facet collection that you want to modify, and then click **Modify** > **Edit collection**.

. Proceed to edit the facet collection as indicated in the [**Create a facet collection** section](#create-a-facet-collection).

### Delete a facet collection

To delete an existing [facet collection](https://docs.coveo.com/en/p5890502/) from within the **Facet** manager:

. Locate the facet collection that you want to delete, and then click **Modify** > **Delete**.

## All facet fields tab

The **All facet fields** tab provides merchandisers with a list of all the available [facet fields](https://docs.coveo.com/en/p9pn0467/) for the selected property.

From this tab, merchandisers can modify specific facet settings.

> **Note**
>
> Certain [facet field](https://docs.coveo.com/en/p9pn0467/) batch-update operations can be performed using the [Coveo Commerce API](https://docs.coveo.com/en/103#tag/Facet-Field-Configurations).
> This can be useful when synchronizing the information in your Product Information Management system with the information in your [CMH](https://docs.coveo.com/en/o5290573/).
> For more information, consult the [Commerce API - Facet field management](https://docs.coveo.com/en/pb5d0258/) article.

![Facet manager fields tab | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facet-manager-all-facet-fields.png)

[cols="1,5"]
|===

|1
|The [dots] button lets merchandisers resynchronize the [facet field](https://docs.coveo.com/en/p9pn0467/) list and bring in the latest changes made to the source.

|2
|The **Facet field** list displays all the [facet fields](https://docs.coveo.com/en/p9pn0467/) available and their configurable settings.

|3
|The **Modify** button lets the merchandiser edit the [facet field](https://docs.coveo.com/en/p9pn0467/)'s settings.
When saved, these changes will be applied throughout the [storefront](https://docs.coveo.com/en/p33g0410/).

|4
|The **Add translation** button appears when at least one of the field's display names is empty.
This button lets merchandisers add a missing translation value to the [facet field](https://docs.coveo.com/en/p9pn0467/).
|===

### Modify facet fields

> **Important**
>
> When a [facet field](https://docs.coveo.com/en/p9pn0467/)'s settings are modified, the changes are applied throughout the selected [property](https://docs.coveo.com/en/p4ue0547/).

To modify a facet field configuration:

. At the end of the facet field row, click **Modify**.

** On the **Facet** tab:

.. Under **Displayed name**, enter a facet display name for each available language.

> **Important**
>
> It's important that all languages within a facet field are assigned a display name, especially when using [relevance-based](https://docs.coveo.com/en/p3oa0420#facets-selected-by-relevance) facets.
> 
> Example: The facet field `prod_cat_color` would appear as such on the storefront if a display name wasn't assigned.

.. From the **Facet type** dropdown menu, select the appropriate [facet type](https://docs.coveo.com/en/p3oa0420#facet-types).
.. Under **Selection options**, choose whether the facet should be a single or multi-select facet.

.. Under **Facet default state**, choose whether the facet values should be open or closed by default.

.. Under **Advanced options**, use the **Include in filter suggestions** button to select whether this facet should be eligible for filter suggestions.
Note that the [search interface](https://docs.coveo.com/en/2741/) must also be configured to display filter suggestions.
See [Implement filter suggestions and instant products](https://docs.coveo.com/en/o8ce0240/) for more information on configuring filter suggestions using Coveo Headless.

** On the **Values** tab:

.. Choose the type of [value sorting](https://docs.coveo.com/en/p3oa0420#facet-values-sorting-methods).

.. Enter the number of values displayed before a visitor needs to select **Show more**.
The default is `100`, and the maximum is `1000` facet values.

. Click **Next: review**.

. Review your changes, and then click **Apply change**.

## Performance tab

The **Performance** tab provides merchandisers with insights into [facet](https://docs.coveo.com/en/198/) performance on [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) and in search [queries](https://docs.coveo.com/en/231/) through the use of [facet engagement](https://docs.coveo.com/en/q1sa0327/).

The [facet engagement](https://docs.coveo.com/en/q1sa0327/) percentage is calculated by dividing the number of times a [facet](https://docs.coveo.com/en/198/)'s values were selected by the number of times the page or search [query](https://docs.coveo.com/en/231/) was viewed.

**Example**

The "Shoes" [PLP](https://docs.coveo.com/en/m1sf3187/) had a total of 20 [visitors](https://docs.coveo.com/en/nbub9475/) in a 24-hour period.
Eight of the [visitors](https://docs.coveo.com/en/nbub9475/) used the "color" [facet](https://docs.coveo.com/en/198/) and two of them used the "size" [facet](https://docs.coveo.com/en/198/).

This results in a [facet engagement](https://docs.coveo.com/en/q1sa0327/) rate of 50% for the "Shoes" [PLP](https://docs.coveo.com/en/m1sf3187/) (`10 clicks / 20 views = 0.5` or 50%).

![Facet manager performance tab | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facet-manager-performance-tab.png)

[cols="1,5"]
|===

|1
|The solution toggle lets merchandisers switch between the **Listing pages** and **Search queries** views.

|2
|The date picker lets merchandisers select the date range for the result display.

|3
|This section displays the top [facet](https://docs.coveo.com/en/198/) engagement generators.

|4
|The **View all listing pages / search queries** button lets merchandisers see a detailed table of all [facets](https://docs.coveo.com/en/198/) and their engagement.

|5
|The **Engagement charts** provide a visual representation of the [facet engagement](https://docs.coveo.com/en/q1sa0327/).
If there's no [facet engagement](https://docs.coveo.com/en/q1sa0327/) data available for the selection, the charts won't be displayed.
|===

### Engagement drill-down

Merchandisers can use this page to drill down through multiple layers of [facet engagement](https://docs.coveo.com/en/q1sa0327/).

#### Solution engagement

Use the solution toggle to display [facet engagement](https://docs.coveo.com/en/q1sa0327/) results for either [PLPs](https://docs.coveo.com/en/m1sf3187/) or search [queries](https://docs.coveo.com/en/231/).
By default, the page showcases the pages or queries that have the most [facet engagement](https://docs.coveo.com/en/q1sa0327/), and displays their metrics in the engagement charts.

Use the **View all listing pages / search queries** button to see a detailed table of all the [facet engagement](https://docs.coveo.com/en/q1sa0327/) metrics.

#### Specific engagement

View the [facet engagement](https://docs.coveo.com/en/q1sa0327/) for specific [PLPs](https://docs.coveo.com/en/m1sf3187/) or search [queries](https://docs.coveo.com/en/231/) by using the dropdown list.
Select one or multiple items from the list to see their combined engagement metrics.

The engagement charts will update automatically to reflect the [facet engagement](https://docs.coveo.com/en/q1sa0327/) for the selection.

#### Facet engagement

View the overall engagement for a specific [facet](https://docs.coveo.com/en/198/) by consulting the **Engagement per facet** chart.
The chart displays the engagement percentage for each [facet](https://docs.coveo.com/en/198/) found in the selection.

#### Facet value engagement

View the engagement breakdown for a specific [facet](https://docs.coveo.com/en/198/) by selecting it from the **Engagement per facet** chart.
Once selected, the **Engagement per facet value** chart displays the engagement for each [facet value](https://docs.coveo.com/en/q1sa6212/).

## The more you know: All about facets

Facets are a powerful way to filter and refine search results based on specific attributes or characteristics of the products being searched.
If you need a quick update on [facets](https://docs.coveo.com/en/198/) in general, consult the following section.

![Facet collection displayed for a search| Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facets-in-search.png)

### Facet types

The Facet manager allows merchandisers to configure different types of facets to refine search results and improve product discovery. Each facet type serves a distinct purpose, helping visitors filter products efficiently based on various attributes. The following facet types are available for configuration:

#### Regular (Selection list)

A standard facet that displays a list of selectable values, allowing visitors to refine their search based on predefined categories.

**Example**

A clothing store with a `Color` facet listing options like Red, Blue, and Green.

#### Hierarchical

A structured facet that organizes categories into multiple levels, allowing visitors to drill down through a product hierarchy.

**Example**

A furniture store with a `Category` facet structured as Living Room > Sofas > Sectionals.

#### Numerical - Slider

A facet that filters results within a numeric range, where values can take any number within the range.
This is commonly displayed as a slider.

**Example**

A price filter where visitors can set a range from $50 to $200.

#### Numerical - Ranges

The facet values are presented as pre-defined value ranges and invite the customer to choose the range that appeals to them.

* **Manual ranges** are established manually by the merchandiser.

* **Automatic ranges** are automatically generated based on the returned products.

**Example**

A shoe store with a price facet could display ranges such as $120-$140, $140-$160, and $160-$180.

### Facet value selection option

Multi-value [facets](https://docs.coveo.com/en/198/) allow consumers to select multiple values within the [facet](https://docs.coveo.com/en/198/), unlike single-value [facets](https://docs.coveo.com/en/198/) which only let consumers select one value.
Not all fields are eligible to be multi-value [facets](https://docs.coveo.com/en/198/), however, only "string" fields can be configured as multi-value [facets](https://docs.coveo.com/en/198/).
For more information on facet construction, consult the [Facet and multi-value facet](https://docs.coveo.com/en/1833#facet-and-multi-value-facet) article.

### Facet ordering

The order in which facets and their values are displayed in the facet collection is an important aspect of the user experience on a storefront.
The CMH provides a combination of manual and automatic ordering options to ensure that the most relevant and important facets are always visible to visitors.

> **Note**
>
> You can pin up to 30 [facets](https://docs.coveo.com/en/198/).

#### Manually pinned facets

Manual pinning allows merchandisers to control the order of facets in the storefront, ensuring they remain fixed in that position.
Use this feature to lock specific facets at the top of the list so they're always visible to visitors.
For example, a clothing store may want to pin the `Brand` and `Price` facets at the top of the list to ensure visitors can always filter by these attributes.

> **Tip**
>
> Consider pinning facets that are used in most of your products (for example, `Category`, `Brand`, or `Price`).
> These attributes are less likely to be selected by relevance alone, so pinning them ensures they remain visible.

#### Facets selected by relevance

Facets selected by relevance let Coveo dynamically choose which facets to display based on the visitor's query or the listing page they're browsing.

> **Note**
>
> Only "Regular" type facets that have the **Facet generator** option enabled on the [**Fields**](https://platform.cloud.coveo.com/admin/#/orgid/content/fields/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/fields/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/fields/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/fields/)) page are eligible to be selected by relevance.

This feature leverages both the [Facet Generator](https://docs.coveo.com/en/n9sd0159/) and the [Dynamic Navigation Experience (DNE)](https://docs.coveo.com/en/m2na0333/) model to optimize which facets appear, and in what order.

When a visitor performs a query or lands on a listing page, the [Coveo Platform](https://docs.coveo.com/en/186/) retrieves the most relevant products.
At the same time, it determines which facets make the most sense to show for that context.

> **Important**
>
> It's important that all languages within a facet field are assigned a display name, especially when using [relevance-based](https://docs.coveo.com/en/p3oa0420#facets-selected-by-relevance) facets.
> 
> Example: The facet field `prod_cat_color` would appear as such on the storefront if a display name wasn't assigned.

The **Facet Generator** looks at which product attributes stand out in the search results.
It prioritizes attributes that are unusually common in the results compared to the overall product inventory.
It also considers how often those attributes appear in the result set, with higher-ranked products being weighted more heavily.
This ensures that the facets shown aren't just popular—but also relevant to the visitor's current context.

Finally, DNE re-ranks the selected facets based on actual visitor behavior, promoting the ones users interact with most often.
This dynamic approach helps you maintain an adaptive experience—without having to constantly update your facet strategy by hand.

> **Tip**
>
> Generic attributes like `category`, `brand`, or `price` often appear across the entire catalog, so they're rarely surfaced by relevance alone.
> To keep those key facets visible, you can manually pin them to the top of your collection.

The following diagram illustrates how Coveo evaluates and selects the most relevant facets to include in the facet collection:

![Diagram showing how facets selected by relevance work | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/facets-by-relevance-flow.png)


**Example**

A merchandiser managing an outdoor gear site wants to improve its facet selection.

To help visitors easily refine their searches, the merchandiser creates a facet collection in the CMH and manually pins the `Brand`, `Size`, and `Price` facets, ensuring that these always appear at the top of the facet list.

To further optimize the shopping experience, the merchandiser activates the **Facets selected by relevance** feature and sets the number of dynamically selected facets to `2`.
These facets will be added alongside the manually pinned ones.
In total, `5` facets will appear on any page using this facet collection.

When a visitor searches for "backpacks", Coveo automatically determines which additional facets to display and the order in which they appear.
In this case, the most relevant facets are `Waterproofing` and `Volume`.
These are added to the manually pinned facets, resulting in the following facet list:

* `Brand`

* `Size`

* `Price`

* `Waterproofing`

* `Volume`

#### Facet values sorting methods

Merchandisers can choose one of the following options to determine how facet values are sorted within the facet collection.

* **Alphanumeric**: Sorts facet values in ascending order based on their alphabetical and numerical characters.
This is typically used for values like brand names or product codes where natural sorting is expected.

* **By number of products (high to low)**: Displays facet values in descending order, from the highest to the lowest number of associated products.
Useful for highlighting the most common or popular values first.

* **By relevance**: Displays facet values in an order influenced by relevance to the current query, based on index ranking and machine learning.
This ensures the most contextually important values appear at the top.