Hierarchy
Overview
The hierarchy facet type lets users navigate through a hierarchical taxonomy.
Available options
Name | Description |
---|---|
Data source | Where to pull values from. Note that the Hierarchy facet requires a taxonomy to function properly. |
Default label | Set the label for the top-level option (default: “Any”). Note: this label is translatable with the facetwp_i18n hook. |
Value modifiers | Enter a list of values (one per line, without commas) to include or exclude from the facet’s choices. The values need to match the label (not the slug) of the value exactly, including spaces and capitalization. See the explanation below. If they don’t work, see this page for more info. |
Sort by | Sort facet choices by:
For custom ways of sorting, for example numerically, you can use the facetwp_facet_orderby hook. |
Count | The number of options to display. Be aware that if your source is a hierarchical taxonomy, the count includes the child terms/categories. If the count is too low, (some) child options will not show up. |
What are value modifiers?
Value modifiers let you include or exclude certain choices from displaying. This setting requires a re-index to take effect.
Below are some examples:
Indexing of term hierarchies

Paris
term selected in the back-end will be displayed in the front-end results if you select “Europe” or “France” in the facet.FacetWP automatically indexes both explicit and implicit term hierarchies.
If your taxonomy includes Europe > France
and a post has only the France
term selected, then Europe
will get indexed too for that post.
On the front-end this means that if you have a post that has only the Paris
term selected, but not its parent terms (France
or Europe
), the post will still be displayed in the results if you filter by “Europe”, or “France” in the facet.
Hide counts
To hide the counts for all facets of type Hierarchy, Checkboxes, Radio, and Range List (in UI modes “None”, “Radio” or “Checkboxes”), add this CSS into your theme’s style.css
:
.facetwp-counter {
display: none;
}
If you need to be specific about which (type of) facet to hide the counts for, use any of the following styles:
/* Hide counts in all Hierarchy facets */
.facetwp-type-hierarchy .facetwp-counter {
display: none;
}
/* Hide counts in a specific Hierarchy facet */
.facetwp-facet-yourfacetname .facetwp-counter {
display: none;
}