Relevanssi – A Better Search


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.

Detta är den kostnadsfria versionen av Relevanssi. Det finns även Relevanssi Premium som har fler funktioner. Mer information om Premium finns på

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.


  • 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-vänligt.
  • Stöd för bbPress.
  • Gutenberg-vänligt.

Avancerade funktioner

  • 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.
  • Stöd för WPML flerspråkstillägg och 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.

Premiumfunktioner (endast med Relevanssi Premium)

  • Indexerar innehåll i bilagor (PDF, Office, Open Office).
  • Improved spelling correction in ”Did you mean?” suggestions.
  • Söker på flera webbplatser i samma multisite-installation.
  • Sök och indexera användarprofiler.
  • Search and index taxonomy term pages (categories, tags, custom taxonomies).
  • Search and index arbitrary columns in wp_posts MySQL table.
  • Tilldela vikt till vilken inläggstyp och taxonomi som helst.
  • Tilldela extra vikt till nya inlägg.
  • Let the user choose between AND and OR searches, use + and – operator (AND and NOT).
  • Inställningar för export/import.
  • WP CLI-kommandon.
  • Relaterade inlägg.
  • Omdirigeringar för sökningar.

Relevanssi på Facebook

Du hittar Relevanssi på Facebook.


  • Cristian Damm for tag indexing, comment indexing, post/page exclusion and general helpfulness.
  • Marcus Dalgren för UTF-8-åtgärder.
  • Warren Tape för 2.5.5-åtgärder.
  • Mohib Ebrahim for relentless bug hunting.
  • John Calahan for extensive 4.0 beta testing.


  • Översiktssida
  • Inställningar för indexering
  • Inställningar för sökningar
  • Inställningar för loggar
  • Utdrag och markeringar
  • Inställningar för synonymer
  • Inställningar för stoppord


  1. Installera tillägget från WordPress tilläggsskärm.
  2. Aktivera tillägget.
  3. Go to the plugin settings page and build the index following the instructions there.
  4. Det är allt!

Relevanssi uses the standard search form and doesn’t usually need any changes in the search results template.

If the search does not bring any results, your theme probably has a query_posts() call in the search results template. That throws Relevanssi off. For more information, see The most important Relevanssi debugging trick.


To uninstall the plugin remove the plugin using the normal WordPress plugin management tools (from the Plugins page, first Deactivate, then Delete). If you remove the plugin files manually, the database tables and options will remain.

Vanliga frågor


You can find solutions and answers at the Relevanssi Knowledge Base.

Kontextuell hjälp

Answers to many common problems can be found from the contextual menu. Just click ”Help” in the top right corner of your WordPress admin dashboard on the Relevanssi settings page.

Relevanssi fungerar inte

If you the results don’t change after installing and activating Relevanssi, the most likely reason is that you have a call to query_posts() on your search results template. This confuses Relevanssi. Try removing the query_posts() call and see what happens.

Searching for words with ampersands or hyphens doesn’t work

Please read Words with punctuation can’t be found. This is a Relevanssi feature, but you can fix it from Relevanssi indexing settings.

Where are the user search logs?

Se i toppen av adminmenyn, där finns ”Sökningar av användare”.

Visning av relevanspoäng

Relevanssi stores the relevance score it uses to sort results in the $post variable. Just add something like

echo $post->relevance_score

to your search results template inside a PHP code block to display the relevance score.

Menade du?-förslag

Relevanssi offers Google-style ”Did you mean?” suggestions. See ”Did you mean” suggestions in the Knowledge Base for more details.

Vad är tf *idf viktning?

It’s the basic weighing scheme used in information retrieval. Tf stands for term frequency while idf is inverted document frequency. Term frequency is simply the number of times the term appears in a document, while document frequency is the number of documents in the database where the term appears.

Thus, the weight of the word for a document increases the more often it appears in the document and the less often it appears in other documents.

Vad är stoppord?

Each document database is full of useless words. All the little words that appear in just about every document are completely useless for information retrieval purposes. Basically, their inverted document frequency is really low, so they never have much power in matching. Also, removing those words helps to make the index smaller and searching faster.


3 december, 2020
Fix WordPress search problems (like quotes managing) out of the box and provide filters to customize search. The author is very helpful has great documentation.
25 november, 2020
I love this plugin, I've now used it on WPBakery Page Builder, and Beaver Builder with some great results, it adds extra functionality (such as highlighting keywords, love that option!). It transforms the clunky default WP search into something miles better.
17 november, 2020
Relevanssi is everything WordPress search should be. Fine-grained control and excellent meta fields/Advanced Custom Fields configurability. Support is excellent and the author is responsive to feature suggestions. I highly recommend the pro version Relevanssi Premium.
13 november, 2020
Implemented this plugin alongside Oxygen Builder app - transforms the WP search functionality making it what it should already be.
Läs alla 286 betyg

Bidragsgivare och utvecklare

”Relevanssi – A Better Search” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.

Bidragande personer

”Relevanssi – A Better Search” har översatts till 10 språk. Tack till översättarna för deras bidrag.

Översätt ”Relevanssi – A Better Search” till ditt språk.

Intresserad av programutveckling?

Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.



  • Changed behaviour: The relevanssi_excerpt_part filter hook now gets the post ID as a second parameter. The documentation for the filter has been fixed to match actual use: this filter is applied to the excerpt part after the highlighting and the ellipsis have been added.
  • Changed behaviour: The relevanssi_index_custom_fields filter hook is no longer used when determining which custom fields are used for phrase searching. If you have a use case where this change matters, please contact us.
  • Minor fix: The relevanssi_excerpt filter hook was removed in 4.9.0. It is now restored and behaves the way it did before.
  • Minor fix: Avoids undefined variable warnings from the Pretty Links compatibility code.
  • Minor fix: The Oxygen Builder compatibility has been improved. Now shortcodes in Oxygen Builder content are expanded, if that setting is enabled in Relevanssi settings.


  • New feature: There’s now a ”Debugging” tab in the Relevanssi settings, letting you see how the Relevanssi index sees posts. This is familiar to Premium users, but is now available in the free version as well.
  • New feature: The SEO Framework plugin is now supported and posts set excluded from the search in SEO Framework settings will be excluded from the index.
  • New feature: There’s a new option, ”Expand highlights”. Enabling it makes Relevanssi expand partial-word highlights to cover the full word. This is useful when doing partial matching and when using a stemmer.
  • New feature: New filter hook relevanssi_excerpt_part allows you to modify the excerpt parts before they are combined together. This doesn’t do much in the free version.
  • New feature: Improved compatibility with Oxygen Builder. Relevanssi automatically indexes the Oxygen Builder content and cleans it up. New filter hooks relevanssi_oxygen_section_filters and relevanssi_oxygen_section_content allow easier filtering of Oxygen content to eg. remove unwanted sections.
  • Changed behaviour: The ”Uncheck this for non-ASCII highlights” option has been removed. Highlights are now done in a slightly different way that should work in all cases, including for example Cyrillic text, thus this option is no longer necessary.
  • Minor fix: Fixes phrase searching using non-US alphabet.
  • Minor fix: Relevanssi would break admin searching for hierarchical post types. This is now fixed, Relevanssi won’t do that anymore.
  • Minor fix: Relevanssi indexing now survives better shortcodes that change the global $post.
  • Minor fix: Warnings about missing relevanssi_update_counts function are now removed.
  • Minor fix: Paid Membership Pro support now takes notice of the ”filter queries” setting.
  • Minor fix: OR logic didn’t work correctly when two phrases both had the same word (for example ”freedom of speech” and ”free speech”). The search would always be an AND search in those cases. That has been fixed.
  • Minor fix: Relevanssi no longer blocks the Pretty Links admin page search.
  • Minor fix: The ”Respect ’exclude_from_search'” setting did not work if no post type parameter was included in the search parameters.
  • Minor fix: The category inclusion and exclusion setting checkboxes on the Searching tab didn’t work. The setting was saved, but the checkboxes wouldn’t appear.


  • New feature: Both relevanssi_fuzzy_query and relevanssi_term_where now get the current search term as a parameter.
  • Minor fix: Relevanssi database tables don’t have PRIMARY keys, only UNIQUE keys. In case this is a problem (for example on Digital Ocean servers), deactivate and activate Relevanssi to fix the problem.
  • Minor fix: When posts_per_page was set to -1, the max_num_pages was incorrectly set to the number of posts found. It should, of course, be 1.
  • Minor fix: Excluding from logs didn’t work if user IDs had spaces between them (’user_a, user_b’). This is now fixed for good, the earlier fix didn’t work.


  • New feature: New filter hook relevanssi_term_where lets you filter the term WHERE conditional for the search query.
  • Minor fix: Doing the document count updates asynchronously caused problems in some cases (eg. importing posts). Now the document count is only updated after a full indexing and once per week.
  • Minor fix: Phrase matching has been improved to make it possible to search for phrases that include characters like the ampersand.


  • Major fix: Changes in WooCommerce 4.4.0 broke the Relevanssi searches. This makes the WooCommerce search work again.
  • Minor fix: Excluding from logs didn’t work if user IDs had spaces between them (’user_a, user_b’). Now the extra spaces don’t matter.
  • Minor fix: The asynchronous doc count action in the previous version could cause an infinite loop with the Snitch logger plugin. This is prevented now: the async action doesn’t run after indexing unless a post is actually indexed.
  • Minor fix: Relevanssi indexing procedure was triggered for autosaved drafts, causing possible problems with the asynchronous doc count action.
  • Minor fix: The relevanssi_index_custom_fields filter hook was not applied when doing phrase matching, thus phrases could not be found when they were in custom fields added with the filter.


  • Changed behaviour: Relevanssi now requires PHP 7.
  • Changed behaviour: Relevanssi now sorts strings with strnatcasecmp() instead of strcasecmp(), leading to a more natural results with strings that include numbers.
  • Changed behaviour: Relevanssi init is now moved from priority 10 to priority 1 on the init hook to avoid problems with missing TablePress compatibility.
  • New feature: New filter hook relevanssi_get_approved_comments_args filters the arguments to get_approved_comments in comment indexing. This can be used to index custom comment types, for example.
  • New feature: Content wrapped in the noindex tags is no longer used for excerpts.
  • New feature: The [et_pb_fullwidth_code] shortcode is now removed completely, including the contents, when Relevanssi is indexing and building excerpts.
  • Major fix: Relevanssi didn’t index new comments when they were added; when a post was indexed or the whole index rebuilt, comment content was included. We don’t know how long this bug has existed, but it is now fixed. Rebuild the index to get all comment content included in the index.
  • Minor fix: Autoload has been disabled for several options that are not needed often.
  • Minor fix: Phrase matching did not work correctly in visible custom fields.
  • Minor fix: TablePress support could cause halting errors if posts were inserted before Relevanssi has loaded itself (on init priority 10). These errors will no longer happen.
  • Minor fix: The doc count update, which is a heavy task, is now moved to an asynchronous action to avoid slowing down the site for users.
  • Minor fix: Relevanssi only updates doc count on relevanssi_insert_edit() when the post is indexed.


  • 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.


  • 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.


  • 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.


  • 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.