The FacetWP Relevanssi Integration Add-On is a specialized bridge plugin that allows FacetWP to use the Relevanssi search engine for its keyword search facets. This combination replaces the basic WordPress search with Relevanssi’s more powerful, weight-based indexing.
This is EXACTLY the same product as distributed by the developer. Sales Page
Purpose: Syncs FacetWP’s “Search” facet type with Relevanssi’s search index and logic.
Version: Current stable versions are typically v0.8.x (compatible with FacetWP 4.0+).
Search Engine Integration: Once activated, a new “Relevanssi” option appears in the “Search engine” dropdown within FacetWP’s search facet settings.
Result Throttling: By default, it respects Relevanssi’s performance settings, often limiting results to 500 items (this can be adjusted via PHP filters).
Relevancy Sorting: Search results are ordered by Relevanssi’s weightings (e.g., titles weighted higher than content) rather than just date.
Fuzzy Matching: Supports partial word matches and “OR/AND” logic as configured in your Relevanssi settings.
Custom Field & Taxonomy Search: FacetWP will return results based on any custom fields or taxonomies indexed by Relevanssi.
AJAX Support: Maintains FacetWP’s signature “no-refresh” filtering while using Relevanssi’s backend results.
Developer Hooks: Includes the facetwp_relevanssi_do_query hook, allowing you to modify the query arguments specifically for this integration.
| Requirement | Specification |
| FacetWP Version | Requires v4.0 or higher for the latest add-on versions. |
| Relevanssi Version | Compatible with both Free and Premium versions. |
| Incompatible Plugins | Does not work with Relevanssi Light. |
| PHP Version | Minimum PHP 7.4+ (Standard for modern WordPress). |
| Data Types | Primarily supports post types. It struggles with Relevanssi’s native handling of Users or Taxonomy terms (unless they are converted to post types). |
Excerpts: Relevanssi-generated excerpts (which highlight keywords) are not automatically pulled into FacetWP listing templates. You must use a custom PHP snippet like relevanssi_do_excerpt() in your template to display them.
Sorting Conflicts: FacetWP’s “Sort” facet uses standard WP_Query ordering. If you use a FacetWP Sort facet alongside a Relevanssi search, the relevancy ordering may be overridden by the sort facet selection.
Large Databases: Because Relevanssi builds a massive index table, performance on shared hosting can degrade if you have tens of thousands of posts.
