Tag: indexing | Relevanssi

January 27, 2026 by Mikko Saari

The wrong content gets indexed for a post

Sometimes Relevanssi can get confused and indexes the post content under the wrong post ID. The main symptoms for this are: You can confirm this problem by checking the posts involved with the Relevanssi debugger that shows how Relevanssi has indexed the post. If you have this specific problem, you’ll find that the posts either…

Indexing only attributes from shortcodes

…do I go about this? – Duke at Remove shortcode but keep content in X parameter You can’t do this using the Relevanssi shortcode removal because that’s a binary operation: the whole shortcode is kept or removed, and there’s no way to keep only part of the shortcode. However, you…I need to add some custom shortcodes to the list of the “removed” ones (so they don’t show in plain text in the results). However, some of them are built like [shortcode_name text=”Need to keep this in results”] and I would like the content in the text parameter to stay in the results. How……the “text” attribute from the shortcode * * @param string $content Post content * * @return string Post content with the shortcode replaced with just the “text” attribute content. */ function rlv_shortcode_attribute( $content ) { return preg_replace( ‘/\ /im’, ‘\1’, $content ); } Since this particular case was about a…

Relevanssi indexes excluded posts

…easy: just add the shortcode to the list of disabled shortcodes. Problem solved! This is easy to do in Relevanssi Premium where the list of disabled shortcodes is a simple setting field on the indexing settings page. With the free version, you can adjust this with the relevanssi_disabled_shortcodes filter hook….…was showing posts from the publication post type, even though that post type was excluded from the index. The reason was a shortcode, publication_archive, that was used on a page to display an archive of publications. The shortcode function fetched the posts with WP_Queryand changed the global $post object. That……theme search is not using Relevanssi for some reason. Common causes for indexing the wrong post types The most common reason for index including the wrong post type is a shortcode or some other feature that displays posts and confuses Relevanssi. In the case that prompted this post, the search…

Indexing product codes with and without spaces

A Relevanssi Premium customer had a problem with product codes. The codes are in the format “ABC 100”, a group of letters and digits with a space in between. Users may search for the codes without the space, so the post should be found with “ABC 100” or “ABC100”. The product codes don’t appear in…

Debugging indexing problems

The easiest way to debug indexing problems is to use the WP CLI tools available in Relevanssi Premium. To see how Relevanssi sees the post 123, just use the following command on the command line: This will print out how Relevanssi sees the post, how it appears in the different steps of the indexing process…

Indexing image captions for the posts

The use case is I run several newspapers, and the “caption” field when uploading media is where the journalists put the photographer credit. We need to be able to index the photographer bylines, but ideally would want to return the story/commentary where their image was used, not the image itself. If you want to index…

Blocking pre and code tags

If your posts have lots of programming code examples in <pre> and <code> tags, those might look pretty bad in the search results. A snippet of programming code isn’t usually a good excerpt, and if you use those tags purely for code snippets, they won’t likely contain significant search content, either. Fortunately it’s easy to…

Indexing with a cron job

I have some trouble with reindexing of new posts. The reason is simple – I sync data into the database automatically. So what I need is a cronjob to reindex the site once a day. How do I do a cronjob? The easiest way would be to get Relevanssi Premium and use WP CLI, so…

Restricting the indexing to particular user roles

From the Relevanssi settings, you can only choose whether subscribers are indexed or not. If you need finer control over what user roles are indexed by Relevanssi, you can use the relevanssi_user_index_ok filter hook with the following code. Place it in your theme functions.php: Just adjust the $block_these_roles array to include the roles you want…

Indexing term slugs

I have a term who name is for, example, Great Blue Trojans. The slug is GBT. I want to be able to search for ‘GBT’ and return all the posts with this term. When I search ‘Great Blue Trojans’ I get the hits. When I search GBT I do not. Is this as expected? Is…