Relevanssi – A Better Search

Wordpress Plugin
Download latest - 4.15.2



Download Stats

Today 1,699
Yesterday 2,293
Last Week 10,923
All Time 1,962,735
Banner 772x250

Relevanssi replaces the standard WordPress search with a better search engine, with lots of features and configurable options. You'll get better results, better presentation of results - your users will thank you.

This is the free version of Relevanssi. There's also Relevanssi Premium, which has added features. For more information about Premium, see

Do note that using Relevanssi may require large amounts (hundreds of megabytes) of database space (for a reasonable estimate, multiply the size of your wp_posts database table by three). If your hosting setup has a limited amount of space for database tables, using Relevanssi may cause problems. In those cases use of Relevanssi cannot be recommended.

Key features

  • Search results sorted in the order of relevance, not by date.
  • Fuzzy matching: match partial words, if complete words don't match.
  • Find documents matching either just one search term (OR query) or require all words to appear (AND query).
  • Search for phrases with quotes, for example "search phrase".
  • Create custom excerpts that show where the hit was made, with the search terms highlighted.
  • Highlight search terms in the documents when user clicks through search results.
  • Search comments, tags, categories and custom fields.
  • Multisite friendly.
  • bbPress support.
  • Gutenberg friendly.

Advanced features

  • Adjust the weighting for titles, tags and comments.
  • Log queries, show most popular queries and recent queries with no hits.
  • Restrict searches to categories and tags using a hidden variable or plugin settings.
  • Index custom post types and custom taxonomies.
  • Index the contents of shortcodes.
  • Google-style "Did you mean?" suggestions based on successful user searches.
  • Support for WPML multi-language plugin and Polylang.
  • Support for s2member membership plugin, Members, Groups, Simple Membership and other membership plugins.
  • Advanced filtering to help hacking the search results the way you want.
  • Search result throttling to improve performance on large databases.
  • Disable indexing of post content and post titles with a simple filter hook.

Premium features (only in Relevanssi Premium)

  • Indexing attachment content (PDF, Office, Open Office).
  • Improved spelling correction in "Did you mean?" suggestions.
  • Searching across multiple sites in the same multisite installation.
  • Search and index user profiles.
  • Search and index taxonomy term pages (categories, tags, custom taxonomies).
  • Search and index arbitrary columns in wp_posts MySQL table.
  • Assign weights to any post types and taxonomies.
  • Assign extra weight to new posts.
  • Let the user choose between AND and OR searches, use + and - operator (AND and NOT).
  • Export and import settings.
  • WP CLI commands.
  • Related posts.
  • Redirects for searches.

Relevanssi in Facebook

You can find Relevanssi in Facebook.

Releases (62 )

Version Release Date Change Log 2020-06-04
  • For some reason the plugin files didn't update in the previous update, ie. 4.7.2 is equal to 4.7.1. This is the real 4.7.2 update.
  • Minor fix: Media Library searches failed if Relevanssi was enabled in the WP admin, but the attachment post type wasn't indexed. Relevanssi will no longer block the default Media Library search in these cases.
  • Minor fix: Adds more backwards compatibility for the relevanssi_indexing_restriction change, there's now an alert on indexing tab if there's a problem.
4.7.2 2020-04-02
  • Minor fix: Media Library searches failed if Relevanssi was enabled in the WP admin, but the attachment post type wasn't indexed. Relevanssi will no longer block the default Media Library search in these cases.
  • Minor fix: Adds more backwards compatibility for the relevanssi_indexing_restriction change, there's now an alert on indexing tab if there's a problem.
4.7.1 2020-03-26
  • New feature: New filter hook relevanssi_post_content_after_shortcodes filters the post content after shortcodes have been processed but before the HTML tags are stripped.
  • Minor fix: Adds more backwards compatibility for the relevanssi_indexing_restriction change.
4.7.0 2020-03-23
  • New feature: New filter hook relevanssi_admin_search_blocked_post_types makes it easy to block Relevanssi from searching a specific post type in the admin dashboard. There's built-in support for Reusable Content Blocks rc_blocks post type, for example.
  • New feature: The reason why a post is not indexed is now stored in the _relevanssi_noindex_reason custom field.
  • Changed behaviour: The relevanssi_indexing_restriction filter hook has a changed format. Instead of a string value, the filter now expects an array with the MySQL query in the index 'mysql' and a reason in string format in 'reason'. There's some temporary backwards compatibility for this.
  • Changed behaviour: Relevanssi now applies minimum word length when tokenizing search query terms.
  • Changed behaviour: Content stopwords are removed from the search queries when doing excerpts and highlights. When Relevanssi uses the untokenized search terms for excerpt-building, stopwords are removed from those words. This should lead to better excerpts.
  • Minor fix: Improves handling of emoji in indexing. If the database supports emoji, they are allowed, otherwise they are encoded.
4.6.0 2020-02-17
  • Changed behaviour: Phrases in OR search are now less restrictive. A search for 'foo "bar baz"' used to only return posts with the "bar baz" phrase, but now also posts with just the word 'foo' will be returned.
  • Minor fix: User Access Manager showed drafts in search results for all users. This is now fixed.
4.5.0 2020-01-29
  • New feature: New filter hook relevanssi_disable_stopwords can be used to disable stopwords completely. Just add a filter function that returns true.
  • Changed behaviour: Stopwords are no longer automatically restored if emptied. It's now possible to empty the stopword list. If you want to restore the stopwords from the file (or from the database, if you're upgrading from an earlier version of Relevanssi and find your stopwords missing), just click the button on the stopwords settings page that restores the stopwords.
  • Changed behaviour: Changes to post weights in the relevanssi_results hook did not affect the relevance scores shown in excerpts. That's changed now, and the displayed scores are now taken from the $doc_weight array, which is returned in the return value array from relevanssi_search().
  • Changed behaviour: Excerpt length and type are now checked outside the loop that goes through the posts. This reduces the number of database calls required.
  • Minor fix: Searching for regex special characters (for example parentheses, brackets) caused problems in excerpts.
  • Minor fix: Improvements in handling highlighting for words with apostrophes.
  • Minor fix: Disregard hanging commas at the end of post exclusion settings.
  • Minor fix: Sometimes excerpts wouldn't have an ellipsis in the beginning even though they should.
4.4.1 2019-12-10
  • Major fix: Returns the missing stopwords.
4.3.4 2019-11-29
  • New feature: You can now give Gutenberg blocks a CSS class relevanssi_noindex to exclude them from being indexed. Relevanssi will not index Gutenberg blocks that have the class.
  • New feature: Relevanssi automatically skips some custom fields from common plugins that only contain unnecessary metadata.
  • New feature: The search results breakdown is added to the post objects and can be found in $post->relevanssi_hits. The data also includes new fields and the breakdown from the excerpt settings page can now show author, excerpt, custom field and MySQL column hits.
  • New feature: Relevanssi can now index Ninja Tables table content. This is something of an experimental feature right now, feedback is welcome.
  • New feature: New filter hook relevanssi_indexing_query filters the indexing query and is mostly interesting for debugging reasons.
  • Minor fix: Deleted and trashed comment contents were not deindexed when the comment was removed. That has been corrected now.
  • Minor fix: Phrase matching is now applied to attachments as well, including the attachments indexed for parent post.
  • Minor fix: Phrase matching only looks at custom fields that are indexed by Relevanssi.
  • Minor fix: Exact match bonus now uses the original query without synonyms added for the exact match check.
  • Minor fix: Paid Membership Pro filtering is only applied to published posts to prevent drafts from showing up in the search results.
4.3.3 2019-09-18
  • New feature: New filter hook relevanssi_indexing_adjust can be used to stop Relevanssi from adjusting the number of posts indexed at once during the indexing.
  • New feature: New filter hook relevanssi_acf_field_value filters ACF field values before they are indexed.
  • New feature: New filter hook relevanssi_disabled_shortcodes filters the array containing shortcodes that are disabled when indexing.
  • Removed feature: The relevanssi_indexing_limit option wasn't really used anymore, so it has been removed.
  • Changed behaviour: Indexing exclusions from Yoast SEO and SEOPress are applied in a different way in the indexing, making for a smoother indexing process.
  • Changed behaviour: WP Table Reloaded support has been removed; you really shouldn't be using WP Table Reloaded anymore.
  • Minor fix: Relevanssi won't choke on ACF fields with array or object values anymore.
  • Minor fix: Relevanssi uninstall process left couple of Relevanssi options in the database.
  • Minor fix: WPML language filter didn't work when fields was set to ids or id=>parent.
4.3.2 2019-08-27
  • New feature: SEOPress support, posts marked "noindex" in SEOPress are no longer indexed by Relevanssi by default.
  • Changed behaviour: Membership plugin compatibility is removed from relevanssi_default_post_ok function and has been moved to individual compatibility functions for each supported membership plugin. This makes it much easier to for example disable the membership plugin features if required.
  • Minor fix: The searchform shortcode now works better with different kinds of search forms.
  • Minor fix: Yoast SEO compatibility won't block indexing of posts with explicitly allowed indexing.
  • Minor fix: The relevanssi_the_tags() function printed out plain text, not HTML code like it should. The function now also accepts the post ID as a parameter.
  • Minor fix: Excerpt creation and highlighting have been improved a little. 2019-08-14
  • Remove notice about undefined index.
4.3.0 2019-08-13
  • New feature: Multi-phrase searches now respect AND and OR operators. If multiple phrases are included in an OR search, any posts with at least one phrase will be included. In AND search, all phrases must be included.
  • New feature: Admin search has been improved: there's a post type dropdown and the search is triggered when you press enter. The debug information has a div tag around it with the id debugging, so you can hide them with CSS if you want to. The numbering of results also makes more sense.
  • New feature: The date parameters (year, monthnum, w, day, hour, minute, second, m) are now supported.
  • New feature: New filter hook relevanssi_indexing_limit filters the default number of posts to index (10). If you have issues with indexing timing out, you can try adjusting this to a smaller number like 5 or 1.
  • New feature: Support for Paid Membership Pro added.
  • New feature: WordPress SEO support, posts marked "noindex" in WordPress SEO are no longer indexed by Relevanssi by default.
  • Removed feature: qTranslate is no longer supported.
  • Major fix: Tax query searching had some bugs in it, manifesting especially into Polylang not limiting the languages correctly. Some problems with the test suites were found and fixed, and similar problems won't happen again.
  • Minor fix: Admin search only shows editing options to users with enough capabilities to use them.
  • Minor fix: Phrase searching now uses filterable post statuses instead of a hard-coded set of post statuses.
  • Minor fix: The plugin action links were missing on the Plugins page list, they're back now.
  • Minor fix: Search terms with slashes won't cause errors anymore.
  • Minor fix: Relevanssi admin pages have been examined for accessibility and form labels have been improved in many places.
  • Deprecated: relevanssi_get_term_taxonomy() function is deprecated and will be removed at some point in the future.
4.3.1 2019-08-13
  • Adding a missing file.
4.2.0 2019-05-27
  • New feature: The search form shortcode has a new parameter dropdown which can be used to add a category dropdown, like this: [searchform dropdown="category"].
  • New feature: Relevanssi can now use the contents of the PDF files indexed with WP File Download.
  • New filter: relevanssi_indexing_tokens can be used to filter the tokens (individual words) before they are indexed.
  • Removed filter: relevanssi_default_meta_query_relation did not have any effect anymore.
  • Changed behaviour: The default taxonomy relation was set to AND in 4.1.4, but wasn't properly applied before. Now it is really switched.
  • Changed behaviour: New post types have been added to list of forbidden post types Relevanssi won't show as indexing options (ACF, TablePress and WooCommerce).
  • Major fix: Tax query processing has been completely refactored, eliminating all sorts of bugs, especially with various edge cases.
  • Major fix: Gutenberg block indexing only worked with the Gutenberg plugin enabled. It now works with WP 5.0 built-in Gutenberg as well. If you use Gutenberg blocks, reindex to get all the block content in the index.
  • Major fix: Excerpt-building and highlighting did not respect the "Keyword matching" setting. They do now, and the excerpts should be better now.
  • Major fix: AND searches needed queries that could get too long for the database to handle. This has been fixed and optimized.
  • Major fix: Taxonomy term subquery relations didn't work; now they are applied.
  • Minor fix: iOS uses curly quotes by default, and that didn't work as a phrase operator. Now phrase operator works with curly quotes and straight quotes.
  • Minor fix: The Did you mean broke with search terms longer than 255 characters.
  • Minor fix: Phrases with numbers and one word like "team 17" didn't work, because numbers weren't counted as words.
4.1.4 2019-05-09
  • EXISTS and NOT EXISTS didnt work for taxonomy terms in searches.
  • WPML post type handling has been improved. If post type allows fallback for default language, Relevanssi will support that.
  • Relevanssi now reminds you to set up automatic trimming for the logs. Its a really good idea, otherwise the logs will become bloated, which will hurt search performance.
  • The Groups posts filter is only applied to public posts to avoid drafts being shown to people who shouldnt see them.
  • The posts_per_page query variable didnt work; its now added to the introduced query variables so that it works.
  • Relevanssi wont log empty queries anymore.
  • The default tax query relation was switched from OR to AND to match the WP_Query default behaviour.
  • When used with WP 5.1, Relevanssi will now use wp_insert_site instead of the now-deprecated wpmu_new_blog.
  • Multisite blog creation is handled better in WP 5.1+.
  • Relevanssi now supports Restrict Content Pro permissions.
4.1.3 2019-02-14
  • Improvements to meta key sorting.
  • Relevanssi settings page won't let you exclude categories you have restricted the search to.
  • Members plugin compatibility has been improved: it's only used if the 'content permissions' feature has been enabled.
  • The excerpt settings page was a bit buggy.
  • Slimstat analytics is now added to the blocked shortcodes list.
  • New filter: relevanssi_search_form works exactly like get_search_form, but only applies to the Relevanssi shortcode search forms.
  • New JetPack taxonomies and post types have been added to the block list so they won't appear in Relevanssi settings.
4.1.2 2018-12-11
  • Choosing "CSS Style" for highlighting was not possible. That is now fixed.
  • Gutenberg reusable block indexing was fatally broken with the latest Gutenberg version. That has been updated.
  • Relevanssi now by default respects the WooCommerce "exclude from search" setting.
  • post__not_in still didn't work properly, it does now.
  • New filter: relevanssi_comparison_order can be used to define the sorting order when sorting the results by post type.
  • "Did you mean" process included a very slow query. It is now cached, leading in some cases to massive performance improvements (we're talking about several seconds here).
  • Highlights inside code and similar blocks are handled better now. 2018-11-12
  • Fixes the broken User searches page.
4.1.1 2018-11-07
  • Relevanssi can now index Gutenberg reusable blocks. (This functionality broke once already before release, so that can happen, since Gutenberg is still in very active development.)
  • The post__in and post__not_in parameters didn't work, and are now fixed. post_parent__in and post_parent__not_in are also improved.
  • You can use named meta queries for sorting posts. Meta query sorting is improved in other ways as well.
  • Log export didn't work properly.
  • Adding stopwords from the common word list has been fixed.
  • The relevanssi_get_words_having filter hook is now also applied to the free version Did you mean queries.
  • New filters: relevanssi_1day and relevanssi_7days can be used to adjust the number of days for log displays, so instead of 1, 7 and 30 days you can have anything you want. 2018-11-06
  • Adding the missing Gutenberg compatibility file. 2018-10-03
  • Actually working admin search.
4.1 2018-10-03
  • New feature: You can now export the search log as a CSV file.
  • New feature: Admin Search page allows you to perform searches in WP admin using Relevanssi.
  • New filter: relevanssi_admin_search_capability can be used to adjust who sees the admin search page.
  • New filter: relevanssi_entities_inside_pre and relevanssi_entities_inside_code adjust how HTML entities are handled inside pre and code tags.
  • Numeric meta values (meta_value_num) are now sorted as numbers and not strings.
  • Pinned posts have $post->relevanssi_pinned set to 1 for debugging purposes, but you can also use this for styling the posts in the search results templates.
  • The Did you mean feature has been toned down a bit, to make the suggestions slightly less weird in some cases.
  • Post parent parameters now accept 0 as a value, making it easier to search for children of any post or posts without a parent.
  • Polylang compatibility has been improved.
  • Phrases with apostrophes inside work better.
  • The relevanssi_excerpt filter hook got a second parameter that holds the post ID.
  • Custom field sorting actually works now.
  • WP Search Suggest compatibility added.
4.0.11 2018-08-03
  • Home page links were getting the highlight parameter even though they shouldn't. This has been fixed.
  • Added support for WP JV Post Reading Groups.
  • Improved handling of HTML entities.
  • Events Made Easy Calendar shortcodes are now removed when building excerpts.
  • set_time_limit() was removed from the indexing; it's no longer necessary, and it can break the indexing on sites that don't allow the use of the function.
  • relevanssi_post_title_before_tokenize filter was moved a bit so that it's the last thing that runs before tokenizing.
  • Disabled shortcodes are handled better in the indexing: the shortcode names won't be indexed anymore like they were before.
  • Made sure there won't be a warning for non-numeric values when searching.
  • New filter: relevanssi_clean_excerpt lets you remove unwanted highlights from excerpts.
  • Highlighting works better with pre and code tags.
  • New filter: relevanssi_comment_author_to_index lets you filter comment author names before indexing.
  • relevanssi_comment_content_to_index doesn't include the comment author name anymore. 2018-05-29
  • The privacy features caused an error notice with certain Relevanssi configurations, and the plugin required WP 4.9.6.
4.0.10 2018-05-28
  • Privacy: If you log search queries, Relevanssi will suggest some additional content to your privacy policy page.
  • Privacy: Relevanssi now supports the new Privacy Policy and Personal Data tools in WordPress 4.9.6.
  • Saving synonyms with quotes worked, but the synonyms showed up wrong.
  • Relevanssi could in some situations override navigation menu links with links to the user profiles or taxonomy terms found in the search. This update fixes that behaviour.
  • Random order works again; using orderby rand didn't work properly. The rand(seed) format is also supported now.
  • Fixed quotes and apostrophes in Did you mean suggestions.
4.0.9 2018-04-30
  • Fixes broken tag and category indexing and searching. If you use tags and categories, rebuild the index after updating.
  • Fixes phrase highlighting in documents.
  • New filter: relevanssi_indexing_restriction allows filtering posts before indexing.
  • New WooCommerce product visibility filtering tool makes WooCommerce product indexing faster.
  • MemberPress post controls were loose and showed drafts to searchers. That is now fixed.
  • Highlighting was too loose, even if matching was set to whole words.
  • Highlighting now works better in cases where there's a hyphen or an apostrophe inside a word.
4.0.8 2018-04-24
  • Fixed cases where Relevanssi added an ellipsis even if the excerpt was from the start of the post.
  • Highlighting now works with numeric search strings.
  • Improved highlighting for accented words. Thanks to Paul Ryan.
  • A surplus comma at the end of post exclusion setting won't break the search anymore.
  • Fixed instructions for adjusting the throttle limit.
4.0.7 2018-04-03
  • Recent post bonus is now applied to searches.
  • Exact term setting can now be disabled.
  • Users of Members plugin would have drafts appear in search results. This is now fixed.
4.0.6 2018-03-29
  • Indexing bugs squashed.
  • Missing tag and category weight settings returned.
  • Fusion builder shortcodes are removed from excerpts.
  • MemberPress post control was backwards.
  • User searches page reset buttons fixed.
  • WPML language filter fix.
4.0.5 2018-03-29
  • Relevanssi code has been reviewed and modified to follow WordPress coding standards. As a result, there have been minor improvements all around the code to make things more robust and secure.
  • Custom field detail is no longer serialized. It's now JSON. If you use custom field detail, rebuild the index and change your code to use json_decode() instead of unserialize().
  • relevanssi_the_tags() and relevanssi_get_the_tags() now have different set of parameters, more in line with the_tags() and get_the_tags().
  • Taxonomy indexing settings were emptied out if you saved another options tab. That is now fixed.
  • Improvements to WPML support; WPML is now less likely to be confused in multisite searches.
  • Updated filter: relevanssi_search_ok now gets the WP_Query object as a parameter, which is helpful if you're not using the global $wp_query.
  • ACF Flexible Content field indexing didn't work properly, possibly due to a change in ACF. That should now work better.


4.0.4 2018-03-26
  • Codebase review, lots of small improvements everywhere.
4.0.3 2017-12-15
  • Relevanssi didn't index all posts with one go. It does now.
  • and symbols caused problems in indexing; they are now included in the default punctuation removal.
  • In some cases excerpt-building could take ages because of autoembed link discovery. Relevanssi now blocks the autoembed procedure in link-building.
  • New filter: relevanssi_custom_field_value is used to filter custom field values both before indexing and before excerpt-building. Parameters include the field name and the post ID.
  • Updated filter: relevanssi_index_custom_fields now gets a second parameter that contains the post ID.
4.0.2 2017-12-04
  • Removed couple of error notices in the code.
  • Improved the support for page builders.
  • Improvements to the Polylang setting.
4.0.1 2017-12-01
  • The plugin can now be uninstalled.
4.0 2017-12-01
  • Legacy code has been removed. If you have a version older than 3.6, update first to to guarantee smooth upgrade process.
  • Improved indexing: no more clicking "Continue indexing" again and again!
  • Settings pages have been completely rewritten.
  • There's documentation in the WordPress contextual help: just click Help on the top right corner.
  • Better Polylang support. A new option to remove the Polylang language filter.
  • Logs can be automatically trimmed. Old log entries are removed to save space.
  • Finally a setting to adjust content weight!
  • Excerpts can use the custom field content.
  • Highlighting in documents is changed: it now requires a highlight query parameter. This helps getting pass caching and makes the highlighting more reliable. To get the query parameter active, use relevanssi_get_permalink() to print out the permalinks on the search results templates.
  • Relevanssi added synonyms to highlighting even if synonyms were not used for searching. In some cases, synonyms were added twice.
  • The User Searches page got a makeover, too.
  • Relevanssi is automatically disabled in REST API searches.
  • Groups and Simple Membership support has been improved.
  • Sorting search results is now up to 300 times faster than before.
  • Lots of improvements all over the place.
  • New filter: relevanssi_excerpt_custom_field_content lets you modify custom field content that is used for excerpts.
  • New filter: relevanssi_punctuation_filter allows for easy modification of punctuation handling.
  • New filter: relevanssi_default_punctuation_replacement changes the default way to handle the rest of the punctuation.
  • New filter: relevanssi_search_again lets you run the search again if no results are found and to modify the parameters between search runs.
  • New filter: relevanssi_fallback allows you to do fallback searches.
  • New filter: relevanssi_page_builder_shortcodes lets you control which page builder shortcodes Relevanssi removes before building the excerpts.
  • New filter: relevanssi_optimize_excerpts makes excerpt-building faster, if you make the filter return true. 2017-10-28
  • A bug in post sorting broke string sorting (mostly post title sorting). 2017-10-27
  • A bug was left in the post ordering code. That bug is now squashed.
3.6.2 2017-10-26
  • Simple Membership plugin is now supported automatically to restrict access to posts.
  • Relevanssi can now handle orderby parameter in array format.
  • Relevanssi now blocks Easy Digital Downloads shortcodes when indexing to improve compatibility with EDD.
  • When using fields to only fetch post IDs, Relevanssi doesn't try to highlight post titles.
  • New action: relevanssi_update_options lets you adjust Relevanssi options immediately after the defaults are set.
  • Remove notices about duplicated database columns when installing the plugin.
3.6.1 2017-10-03
  • SECURITY: This version fixes a SQL injection vulnerability, where a site admin could theoretically inject SQL code into Relevanssi search queries. Doing this required access to Relevanssi settings page and in my tests, I couldn't do any damage, just break the Relevanssi search, but in any case, this vulnerability is now fixed.
  • Search and Filter shortcode is added to the blacklist.
  • Groups plugin is now supported automatically to restrict access to posts.
  • The filter relevanssi_index_custom_fields now works even if the custom field setting is empty.
  • The filter relevanssi_post_to_index now has a second parameter. For posts, it simply repeats the post object, but for taxonomy terms, it has the term object.
3.6.0 2017-08-29
  • Changed a bit how Relevanssi attaches itself to queries. Instead of the global $wp_query, Relevanssi now uses the query passed as the parameter to the_posts filter hook. This should improve compatibility in some cases, but may cause problems in some fringe cases. If you're doing something unusual with Relevanssi, try this out before deploying to public use.
  • Some meta queries caused major problems with the Relevanssi weighting algorithm. This has now been fixed.
  • Error notices caused by trying to use a non-existing taxonomy term have been removed.
3.5.12 2017-08-10
  • Post type exclusion didn't work as expected.
  • Relevanssi couldn't handle nested tax queries (such as those generated by WooCommerce product visibility filtering) properly. 2017-07-07
  • New filter: relevanssi_allow_one_letter_highlights lets you allow one-letter highlights. Just make the filter function return true.
  • New filter: relevanssi_block_one_letter_searches by default blocks one-letter searches. If you want to enable them, add a filter function that always returns false.
  • Fixed an undefined variable notice.
3.5.11 2017-06-29
  • Synonym indexing failed if synonyms contained a forward slash.
  • Highlighting HTML tags has been improved further.
  • New filter: relevanssi_tag_before_tokenize allows you to access tag content before indexing.
  • Relevanssi now actively blocks one-letter search terms, as they are generally pointless and can cause "out of memory" issues. One-letter search terms are no longer highlighted, either. These are usually caused by cases like "word's" being interpreted as "word s".
  • New filter: relevanssi_disable_shortcodes_excerpt lets you add more shortcodes to be disabled before excerpts are built.
3.5.10 2017-05-20
  • Some users got a fatal parse error. That shouldn't happen anymore.
  • FacetWP users ran into trouble, as relevanssi_do_query() started to explicitly expect a WP_Query object in version 1.15.0. That expectation is removed; it's still highly recommended for future compatibility that you use WP_Query objects.
  • Small bug fix: get_current_screen() is now only used when it's available to avoid occasional fatal errors.
  • Error messages from DOING_AJAX being undefined should be removed. 2017-05-14
  • plugin repo didn't like 3.5.9 for some reason, hoping to have better luck with this.
3.5.9 2017-05-14
  • Improved the way highlighting handles HTML tags, especially when highlighting on post pages.
  • The throttle limit setting was removed from the settings page for causing trouble. If you need to change it, update relevanssi_throttle_limit option directly.
  • Relevanssi didn't support tax_queries with field set to name. That works now.
  • Much faster way of showing the 25 most common words in the index. If you've disabled this feature because it was so slow, try enabling it - you might be surprised!
3.5.8 2017-03-28
  • Did you mean function had a XSS vulnerability, which is now removed.
  • Minimum word length wasn't applied to titles in indexing. It is now fixed. If you think this is a problem, rebuild the index.
  • TablePress compatibility has been improved.
  • Meta query handling has been improved, thanks to Maxime Culea.
  • Improved WP_Query parameter support: setting query variable sentence to 1 forces phrase search.
  • Improved ACF compatibility. 2017-01-25
  • Small fix for a bug that broke the settings page.
3.5.7 2017-01-23
  • An improved version of the sorting function will not throw notices when Intuitive Custom Post Order plugin is used.
  • New filter: relevanssi_missing_sort_key can be used to adjust the result sorting when using keys that are not present in all posts (eg. menu_order).
  • Czech translation and stopwords, thanks to Michael Kucera.
  • Relevanssi broke the WP admin menu search when admin searches were enabled.
  • Relevanssi broke the admin page search under WP 4.7. Relevanssi is now disabled in admin page searches.
  • The way accented characters are handled in highlighting is improved. A new filter, relevanssi_accents_replacement_arrays, can be used to adjust the accent replacement. 2016-12-08
  • Fix for a fatal bug in 3.5.6.
3.5.6 2016-11-01
  • Relevanssi admin page had a vulnerability that allowed SQL injection attacks. That is now fixed.
  • Relevanssi didn't like to highlight search terms that are followed by a ?, an ! or an apostrophe.
  • New filter: relevanssi_ok_to_log lets you control whether search queries are logged or not.
3.5.5 2016-10-19
  • 500 errors caused by arrays in custom fields should be gone now.
  • Improvements to the ACF "select" field support.
  • Relevanssi will not break when frontend plugins insert posts.
  • relevanssi_match filter has a new parameter, which contains the search term.
  • Polylang support has been improved.
  • WPML and Polylang filters work when "fields" is set to "ids".
  • New filter: relevanssi_log_get_user gets passed the user object before Relevanssi decides if the query should be logged or not.
3.5.4 2016-08-19
  • Relevanssi had a bug that lead to inflated relevancy scores for posts.
  • Relevanssi can now index the human-readable labels of ACF "select" fields. (Thanks to Raphal Droz.)
  • New filter: relevanssi_30days can be used to adjust the 30 day logs to a different number of days.
  • Adding stopwords that contain apostrophes didn't work.
  • Ensured PHP7 and WP 4.6 compatibility.
  • Fixed a small glitch that could happen if a highlighted term is next to a starting square bracket.
3.5.3 2016-04-20
  • New filter relevanssi_user_searches_limit to adjust the number of user searches shown in the logs.
  • Old data check is only done on Relevanssi settings page, not on all admin pages. That should improve admin performance.
  • Fixed a fatal error when searching includes private posts.
  • New filter: relevanssi_remote_addr can be used to modify the IP address logged to Relevanssi logs.
  • Blocked CFDB and WooCommerce shortcodes that are causing problems with Relevanssi.
3.5.2 2016-01-09
  • Added correct support for term_taxonomy_id in the fields parameter in tax_queries.
3.5.1 2016-01-08
  • Fixed an error in the Did you mean function.
  • Fixed an error if the search term was not found in content.
  • Fixed an error when building excerpts from posts shorter than the excerpt length.
  • Blocked the [starpro] shortcode that was causing problems with Relevanssi.
  • New filter: relevanssi_remove_stopwords_in_titles allows you to include stopwords in titles.
  • Added support for term_tax_id in the fields parameter in tax_queries.
  • Excerpt-building failed if multibyte string operations were missing. It should work now.
3.5 2015-12-10
  • Tokenizer was using strlen() and not mb_strlen(), so word lengths were not calculated properly. If your site uses non-ASCII alphabet, rebuilding the index is a good idea.
  • Small improvement to WPML multilanguage filtering.
  • relevanssi_the_title() got a new parameter: if you don't want to echo the title, you can use it like relevanssi_the_title(false) to make it return the title.
  • Relevanssi had the_title filter hook calls that were missing the second parameter; that's now fixed.
  • The excerpt-building algorithm is completely rewritten based on work by Ben Boyter (
  • The [watupro] shortcode didn't work with Relevanssi, so Relevanssi will now bypass it.
  • The plugin i18n features have been improved slightly.
  • New filter: relevanssi_didyoumean_suggestion lets you modify the Did you mean? suggestion before it's displayed.
  • relevanssi_didyoumean() has a new parameter: you can now choose whether the result is echoed out (the default value) or just returned.
  • In the search results breakdown, you can now use %categories% and %taxonomies% to show the number of matches in categories and taxonomies other than tags and cats, respectively.
  • Relevanssi supports fields parameter (both ids and id=>parent) to return only post IDs or post IDs and post parents.
3.4.2 2015-09-17
  • Empty lines on synonym settings caused problems. Fixed that.
  • In WordPress 4.2 installations, emoji in will be handled better. Emoji in posts may cause problems with WordPress versions below 4.2, so please update!
3.3.8 2014-12-20
  • Fixed a bug that caused the results to change depending of the order of words in a multi-word search query.
  • Added product_categories and recent_products from WooCommerce to the list of blocked shortcodes.
  • There are improvements in excerpt-building and highlighting, especially when fuzzy search is enabled.
  • Fixed a possible (if quite unlikely) XSS vulnerability.
  • Improved search performance (thanks to MikeNGarrett).
  • Sometimes highlights in documents make the document content disappear. I don't know why, but I've added a fix that should make the content visible (without the highlights) if a problem appears.
3.2 2013-12-13
  • Fixed a bug in the TablePress support.
  • Titles are put through the_title filter before indexing.
  • New filter: relevanssi_join can be used to join tables in the Relevanssi search MySQL queries. Thanks to Ninos Ego.
  • New filter: relevanssi_post_content can be used to modify post content before any Relevanssi processing.
  • New filter: relevanssi_post_content_before_tokenize can be used to modify post content just before it's tokenized.
  • New filter: relevanssi_indexing_values can be used to modify what Relevanssi stores in the index.
  • New filter: relevanssi_default_meta_query_relation can be used to change the default meta query relation (default value is "AND").
  • When using a meta_query, relation can be set to OR now.
  • Phrases are now matched to excerpts.
  • Number of queries Relevanssi generates is much, much lower.
  • New filter: relevanssi_didyoumean_url lets you modify the URL generated by the did you mean feature.
  • Better set of Russian stopwords.
  • Relevanssi now highlights search query synonyms as well in documents.
3.1.9 2013-10-25
  • Fix to make Relevanssi compatible with WordPress 3.7.
  • Fixed a mistyped database table name.
  • Relevanssi disables responsive-flipbook shortcode in indexing; it was causing problems.
  • Fixed a problem with an author dropdown with no author selected.
3.0.5 2012-09-29
  • AFTER UPGRADING FROM 2.x: Make sure you deactivate and reactivate Relevanssi in order to make the database changes happen.
  • Fixed a major bug that caused the searches to fail when "Limit searches" was enabled, but "Limit" was not defined.
  • Modified relevanssi_remove_punct() to replace curly apostrophes and quotes with spaces instead of removing them, to make the index more consistent (regular apostrophes were replaced with spaces). Reindexing the database is a good idea.
  • Fixed some misleading text on the options page.