Using Facets

A facet is a search interface component that allows you to refine your list of search results. It consists in a list of values associated to an aspect of the items presented in the search results. By selecting the desired values, you filter out search results that do not match your selection. The facet content is updated each time you interact with other facets or with the search box.


If your search interface window is very narrow, for instance when it is embedded as a panel in a page or displayed on a mobile device, facets are available in the Filters drop-down menu.


If you are a Coveo Cloud administrator, make sure to also read Facet Types, Interface Editor, and JavaScript Search Interface Editor.

Facet Features

Parts of a Facet

1 The Type facet shows a list of item (i.e., search result) types.
2 With the Account and Opportunity values selected, the search results consist in accounts and opportunities only.
3 Number of matching search results for each selected facet value.
4 Search appears when there are additional values available. Click and type a few characters to search the values.
5 Click the X to clear all selected values in a facet.
6 In the More menu (More icon), select one of the available values to reorder facet values by number of Occurrences, Score, or Label, and either in Ascending or Descending order.
7 In the More menu, click Collapse to hide facet values and therefore reduce the facet size.
8 Hover over a facet value and click the X on the right to exclude the corresponding items from the search results.
9 Click Expand icon to extend or Reduce icon to reduce the list of values.

Not all facets look like those in the figure above. See Other Facet Types for a description of the two other facet types you may see in a search interface.

Selecting Several Values

To refine your search, you can select more than one value in a facet and you can select values in more than one facet. Each value selected or excluded is a filter applying on top of your other selections. The search results are updated accordingly and show the search results matching all your selections only.

The following facets allow you to filter search results by year and month of publication.


When you select 2016, 2017, February, March, and April, the displayed search results are items published in February, March, or April 2016, or February, March, or April 2017.

Deselecting Values

Above the search results, the selected and excluded facet values are displayed. Click the X next to a value to delete this filter, or click Clear to clear all filters and display the original, complete list of results matching your query.

This search interface shows all results published in any month of 2017 but May.


Excluding Values

When you hover to the right of the result number of a facet value, an X button appears. Click this button to exclude the corresponding value. As a result, all items but those matching the excluded value appear in your search results.

Before you click the X, all search results are displayed, regardless of their month of publication. When you click it, the result list updates to show all results but the 42 published in May.


Searching for Values

The values in a facet are typically listed by descending number of corresponding search results, but you can also use the facet search box to look for specific, less common field values. If you are looking for a specific value, click Search and type it in the search box. You can then select or exclude this value.

Searching a Facet Value

Other Facet Types

Most facets consist in a list of values with a checkbox next to each of them. To refine your search results, you check the boxes corresponding to the desired values. Some facets offer a different way to select values. However, the result of your selection is the same: items not matching the selected values are filtered out of your search results.

Slider Facet

A slider facet contains a slider widget that allows the end user to filter search results based on a range of numerical values.

You can use the facet slider to select a range of publication dates. Only items published within this range appear in your search results.

Slider Facet

Category Facet

A category facet displays values in a hierarchical fashion. It allows you to refine your search results based on how items are organized in a system. The value you select corresponds to a path, and any item not matching this path is excluded from your search results.

Through a Coveo-powered search interface, you can access your personal Google Drive, which you organized as follows:

  • Documents folder: 146 files
    • Bills folder: 130 files
    • Taxes folder: 16 files
  • Downloads folder: 118 files
  • Images folder: 40 files
    • John's Baby Pictures folder: 8 files
    • Trip to Boston folder: 32 files
  • Music folder: 21 files
    • Abbey Road - The Beatles folder: 10 files
    • Low - David Bowie folder: 11 files
  • Videos folder: 35 files
    • Concerts folder: 10 files
    • Cat Videos folder: 20 files
    • Karaoke Nights folder: 5 files

Initially, the Folder facet appears as follows:

Category Facet

Since you are looking for tax documents, you click Documents. The Folder facet then updates to show the folders in the Documents folder, i.e., Bills and Taxes. When you click Taxes, your search results are further restricted to the items in the Taxes folder only.

Category Facet