X Features Cars Demo Power Plants Demo State Parks Demo Site Showcase Docs Tutorials Add-ons Buy

Facet Configuration


Facets are UI elements (checkboxes, dropdowns, etc.) used to filter, or “drill down”, content listings. Facets are aware of the content, and only relevant choices are displayed.

Creating a Facet

Browse to Settings > FacetWP, then click on “Add New” beside the Facets header. FacetWP includes a sample facet (Categories) to help get you started.


Each facet has its own set of options (which vary depending on the facet type).

Building the Index

After you’ve saved your facets, click the Re-index button. This may take a few minutes depending on how much content exists on your site, so please be patient. The progress bar below the button will refresh every few seconds with the percent completion.


Using a Facet

Facets can be displayed using shortcodes (in the body field, or text widgets) or PHP (in template files). For a facet named my_facet, you can use the shortcode:

[facetwp facet="my_facet"]

Or the PHP code:

<?php echo facetwp_display( 'facet', 'my_facet' ); ?>

IMPORTANT: facets only appear if a FacetWP template exists on the page. Please see Template Configuration to learn more.

See Also

Template Configuration