Related Articles

summary the related articles feature lets editors attach a curated list of related articles to any post articles can be found using a classic keyword search , or discovered automatically using the similar function, which analyses the post's title and content to surface thematically related content from the same hub prerequisites the basic related articles panel (with keyword search) is available on all hubs out of the box the similar function requires additional setup the elasticpress plugin must be active on the hub elasticpress must have completed at least one content sync the related posts feature must be enabled in elasticpress navigate to elasticpress → features → core search → related posts and enable it elasticpress plugin settings screen showing where to configure the related posts feature note the feature can be disabled entirely by a hub administrator via hub settings → hide related articles if you do not see the related articles panel, contact your administrator usage open any article for editing (standard post type) the related articles panel appears below the editor the panel is split into two columns the left side shows candidate articles you can pick from, and the right side shows your current selection below the panel, two buttons let you switch between the two ways of finding articles search and similar screenshot of the purple hub editor displaying an article and the related articles panel with a candidates selection below searching for articles manually search is the default mode a search field is displayed above the left hand candidates list type a keyword to filter the list results update as you type and show published articles each result displays the article title and its publication date, so you can distinguish between articles with similar titles click any article in the left hand list to add it to your selection on the right finding similar articles automatically if elasticpress is configured (see /#prerequisites ), a similar button appears next to the search button click similar to let purple hub suggest related articles automatically the search field is hidden and the candidates list is replaced with suggestions based on the current post's content similarity is determined by the post title and the post's content up to 20 suggestions are returned fallback behaviour if elasticpress cannot produce results for a given post — for example because the content is very short or no closely related articles exist — the similar function falls back first to articles that share the same tags or categories, and then to the most recently published articles you may therefore occasionally see less precise suggestions; this is expected you can switch back to search mode at any time by clicking the search button any articles you have already added to your selection remain there regardless of which mode you switch to managing your selection add an article by clicking it in the left hand candidates list remove an article by hovering over it in the right hand selection list and clicking the remove button that appears on the right edge reorder articles by clicking and holding an entry, then dragging it to the desired position saving once you are happy with your selection, save or publish the post as usual the related articles list is saved with the post and will persist after a page refresh technical note related articles are stored as an acf relationship field ( purple related articles ) on the post the list of related article ids is accessible to developers via get field('purple related articles', $post id) or through the standard acf api limitations related articles are only supported for the standard post type custom post types are not supported the similar function is only available when elasticpress is active and the related posts feature is enabled (see /#prerequisites ) if polylang or polylang pro is active on the hub, the similar function only suggests articles in the same language as the current post