Facets Engine

Facets are the individual filter controls your visitors interact with (like a Price Slider, a Color Swatch, or a Category Checkbox). FilterX separates the "UI Design" of a facet from "Where the Data Comes From", giving you ultimate flexibility.

The Anatomy of a Facet

Every facet in FilterX is built using three simple concepts. You mix and match these to create the perfect filter experience.

🔌

1. The Source

Where the data lives. Is it a WooCommerce Price? An ACF Custom Field? A standard WordPress Category? FilterX auto-detects them all.

💡 Example: Use 'ACF Field' to let users filter houses by 'Number of Bathrooms'.

🎨

2. The UI Type

How the user interacts with it. You can display the exact same data as a Dropdown, a list of Checkboxes, or clickable Pill buttons.

💡 Example: Display product sizes (S, M, L) as a 'Button Group' instead of a boring dropdown.

🔗

3. The Grid Link

Which Grid the filter controls. Because facets are standalone widgets, you can place them anywhere on the page (like a sidebar or a top bar) and link them to any grid.

💡 Example: Place a 'Search Bar' facet in your site header that controls a grid on the main shop page.

Universal Facet Settings

Whenever you create or edit a Facet in the FilterX admin panel (/wp-admin/admin.php?page=filterx-facets), you configure the following universal settings:

Control / Setting	Description
Facet Name	The internal label for this facet, and the fallback text displayed above the filter in the UI (e.g., 'Filter by Brand').
Facet Slug	A unique URL-safe identifier automatically generated from the Name. This is what you select in the Elementor/Gutenberg widget.
Data Source	Choose the master list of options. Options include Taxonomy Terms, Post Meta keys, ACF Fields, or WooCommerce Attributes.
Source Key	The specific identifier in the database. For example, if Source is 'Taxonomy', the Source Key might be 'product_cat' or 'post_tag'.
Status	Set to 'Publish' to make it live, or 'Draft' to hide it from the frontend without deleting its indexed data.

Note: In addition to these universal settings, every UI Type (Checkbox, Range Slider, etc.) reveals its own specific configuration controls. View type-specific settings here.

Available Data Sources

Taxonomy Terms

Any standard WordPress taxonomy (Categories, Tags, Custom Taxonomies).

Perfect for: Filtering blog posts by Category or authors.

Advanced Custom Fields (ACF)

Deep integration with ACF, including nested repeater fields.

Perfect for: Filtering cars by ACF fields like 'Mileage' or 'Engine Type'.

WooCommerce Specifics

Auto-detects native Woo data (Price, Stock Status, On Sale, Average Rating).

Perfect for: Creating a 'Show only In-Stock items' toggle.

Post Meta

Any custom meta key stored in your database.

Perfect for: Filtering by a custom field added by your theme.

← Quick Start Facet Types →