Integrations

FilterX auto-detects popular plugins and enables deep integrations. All integrations follow a common IntegrationInterface contract.

ACF

Advanced Custom Fields (ACF)

When ACF is active, FilterX registers acf:field as a facet source. You can use any ACF field as a filter source, including nested repeater notation.

Supported ACF Field Types

Text
Number
Select
Checkbox
Radio
Taxonomy
Relationship
Post Object
Repeater (sub-fields)
Flexible Content

# ACF facet examples

source: "acf:field", source_key: "brand"

source: "acf:field", source_key: "specs.material" // repeater.subfield

ACF field discovery endpoint: GET /wp-json/filterx/v1/fields/acf?post_type=product

EL

Elementor

FilterX registers native Elementor widgets so you can add filter/grid combos directly in the Elementor page builder without shortcodes.

FilterX Grid

Full grid widget with configurable layouts, limits, and columns

FilterX Facets

Standalone facet widget — link to your grid visually by selecting it from a dropdown

💡 Use Case: Build your complete shop layout visually without writing a single line of code. Simply drag the Grid onto the page, drop the Facets widget into a sidebar column, and select which Grid it controls.
GB

Gutenberg Blocks

FilterX registers Gutenberg blocks for use in the WordPress Block Editor with 100% Full Site Editing (FSE) support.

<!-- Gutenberg block example --> <!-- wp:filterx/grid {"gridId": 15, "columns": 3} /--> <!-- wp:filterx/facets {"facetIds": [4, 7, 12]} /-->

Blocks feature a full settings panel in the Gutenberg inspector sidebar, including a live real-time server-side preview of your actual grid and facets right inside the editor.

WPML

WPML & Polylang (Multilingual)

When WPML or Polylang is detected, FilterX scopes all index queries and REST responses to the current active language.

  • Facet choices automatically show only values from the current language's posts
  • Grid queries include a language filter so only posts in the active language are returned
  • Facet names and labels are translateable via WPML or Polylang string translation
  • REST API respects the lang query parameter: GET /wp-json/filterx/v1/facets?lang=fr
Note: Run a full re-index after activating WPML/Polylang to ensure the index contains language metadata.

Caching Plugins

FilterX is compatible with major caching plugins. REST API responses include ETags and Cache-Control headers. Dynamic filtering should be excluded from page caching.

WP Rocket

Exclude /wp-json/filterx/* from page cache rules

W3 Total Cache

Enable object caching; REST endpoints self-cache via ETags

LiteSpeed Cache

Exclude wp-json/filterx from ESI or page caching

Redis / Memcached

FilterX supports cache driver selection in Settings → Performance