Category Archives: Knowledge Base

Knowledge base contains information on how to use Relevanssi. There are lots of features that are documented in the knowledge base. Here’s an index to the knowledge base, with all the entries sorted under different topics.

The most important troubleshooting trick

Advanced hacking, filter hooks

Search results pages

Search more



Plugin compatibility

Theme compatibility

ACF subfields

If you have subfields or repeater fields in ACF, Relevanssi doesn’t understand the field_%_subfield notation. You can have Relevanssi index subfields by setting the custom field setting to all: that makes Relevanssi index all custom fields, which includes the repeater fields. If you want more control, Simon Wheatley has created Relevanssi: add ACF subfields to […]

Infinite Scroll from Jetpack

Jetpack has Infinite Scroll, which is a pretty cool feature, but unfortunately doesn’t work with Relevanssi on search results pages. Infinite Scroll uses WP_Query to get more posts, and that isn’t compatible with Relevanssi. I’m not aware of a solution that would allow Infinite Scroll to work with Relevanssi. There isn’t enough room for customization […]

Excluding posts by taxonomy

Relevanssi has a category exclusion feature built in, but that only works for basic categories and not any other taxonomies. You can use tax_query to restrict the searches as well, but that’s more complicated than adjusting the setting in Relevanssi settings. However, if the exclusion is permanent, it’s best done in the indexing level. That […]

Issues with post order plugins

If you’re getting low quality results and the weight settings are not affecting the results, the first thing to check is to see if your results are coming from Relevanssi in the first place. That’s easy to check: disable Relevanssi and see if the results change. If the results change, they’re coming from Relevanssi. If […]

Deindexing Yoast SEO noindex posts

If you use Yoast SEO to mark posts “noindex”, you may want to have Relevanssi deindex those posts as well. It’s easy to do using the relevanssi_do_not_index hook. Just add this function to your theme functions.php: add_filter(’relevanssi_do_not_index’, ‘rlv_yoast_noindex’, 10, 2); function rlv_yoast_noindex($do_not_index, $post_id) { $noindex = get_post_meta($post_id, ‘_yoast_wpseo_meta-robots-noindex’, true); if ($noindex) $do_not_index = true; return […]

Relevanssi and Polylang

Relevanssi has an option that restricts the multilanguage searches to just current language. With Polylang, that setting doesn’t actually do anything. Polylang always restricts the searches to the current language. If you want to remove that restriction, you need to disable the taxonomy setting Polylang adds to the searches. You can do it with this […]