Checkboxes

Overview

The checkbox facet type lets users select multiple values.

facet-type-checkboxes

Available Options

Name Description
Data source Where the values live (taxonomy, custom field, post attribute)
Parent term If Data Source is a hierarchical taxonomy and you want to display only child terms, enter the parent term’s ID.
Value modifiers Enter a list of values (one per line) to include or exclude from the facet’s choices
Hierarchical Whether to indent child terms (this option only appears if Data Source is a taxonomy)
Show expanded Should child terms be visible by default?
Show ghosts Show choices that would return zero results?
Preserve ghost order Keep ghost choices in the same order (mixed with valid choices)?
Facet logic Assume a facet with the choices “Apple”, “Banana”, and “Pear”.

  • AND (match all) – if selecting “Apple”, the choices “Banana” and “Pear” will disappear.
  • OR (match any) – if selecting “Apple”, the choices “Banana” and “Pear” will remain. If you select both “Apple” and “Banana”, results matching EITHER will remain.
Sort by Sort facet choices by Facet Count, Display Value, Raw Value, or Term Order
Count The number of options to display
Soft limit The number of options before showing the “See more” link. Set to 0 to display all options.

What are ghosts?

Ghosts are facet choices that do appear in the unfiltered results — but disappear after being filtered out. If a facet choice has no associated content, then it will never appear.

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.

Hide Counts

To hide counts, add this CSS into your theme’s style.css:

.facetwp-counter {
    display: none;
}