Overview
Relevanssi describes itself as: “Relevanssi replaces the default search with a partial-match search that sorts results by relevance. It also indexes comments and shortcode content.”
It is active on 100,000+ WordPress sites and rated 4.8 out of 5 by 406 users on WordPress.org. Developers can extend it through 13 actions and 172 filters, listed below.
How to install Relevanssi
- Open the plugin installer. In your WordPress dashboard go to Plugins → Add New Plugin.
- Search for it. Type “Relevanssi” and pick the one by Christoph Vielgrader.
- Install and activate. Click Install Now, then Activate.
Install with a zip file or WP-CLI
Download the zip from the WordPress.org plugin page, then go to Plugins → Add New Plugin → Upload Plugin, choose the file and click Install Now. Or from the command line:
wp plugin install relevanssi --activateRequirements: WordPress 4.9+ · PHP 7.1+ · tested up to WordPress 7.1.4
Hooks & customisation
Relevanssi 4.28.8 fires 13 actions and 172 filters. Use them from your child theme or a snippets plugin to change how it behaves without editing its files.
// This filter is documented in lib/indexing.php
apply_filters( 'relevanssi_indexing_tokens', … );
// Adds in a missing sorting value.
apply_filters( 'relevanssi_missing_sort_key', $key1, $key );
// Filters the capability required to access Relevanssi options.
apply_filters( 'relevanssi_options_capability', 'manage_options' );
// This filter is documented in wp-includes/post-template.php
apply_filters( 'post_password_required', false, $post );
// Filters the capability required to access Relevanssi admin search page.
apply_filters( 'relevanssi_admin_search_capability', 'edit_posts' );
// Filters whether meta query can use REGEXP or NOT REGEXP comparison. This is a…
apply_filters( 'relevanssi_allow_meta_query_regexp', false );Need Relevanssi customised?
Tell us what you want changed, added or fixed and we'll reply with an estimate.
WP EXPERTS is independent and not affiliated with Christoph Vielgrader. Plugin names and logos belong to their owners. Version, rating and install figures from WordPress.org, checked Nov 17, 2026.