Hugo uses a set of factors to identify a page’s related content based on front matter parameters. This can be tuned to the desired set of indices and parameters or left to Hugo’s default Related Content configuration.
List related content
To list up to 5 related pages (which share the same date or keyword parameters) is as simple as including something similar to this partial in your single page template:
Custom configuration should be set using the same syntax.
Top level configuration options
(int) A value between 0-100. Lower value will give more, but maybe not so relevant, matches.
(bool) Set to true to include pages newer than the current page in the related content listing. This will mean that the output for older posts may change as new related content gets added.
(bool) Set to true to lower case keywords in both the indexes and the queries. This may give more accurate results at a slight performance penalty. Note that this can also be set per index.
Configuration options per index
(string) The index name. This value maps directly to a page parameter. Hugo supports string values (author in the example) and lists (tags, keywords etc.) and time and date objects.
(string) One of basic(default) or fragments.
(string) Apply a type specific filter to the result of a search. This is currently only used for the fragments type.
(int) An integer weight that indicates how important this parameter is relative to the other parameters. It can be 0, which has the effect of turning this index off, or even negative. Test with different values to see what fits your content best.
(int) A percentage (0-100) used to remove common keywords from the index. As an example, setting this to 50 will remove all keywords that are used in more than 50% of the documents in the index. Default is 0.
(string) This is currently only relevant for dates. When listing related content, we may want to list content that is also close in time. Setting “2006” (default value for date indexes) as the pattern for a date index will add weight to pages published in the same year. For busier blogs, “200601” (year and month) may be a better default.
(bool) See above.
Fast is Hugo’s middle name and we would not have released this feature had it not been blistering fast.
This feature has been in the back log and requested by many for a long time. The development got this recent kick start from this Twitter thread:
Scott S. Lowe removed the “Related Content” section built using the intersect template function on tags, and the build time dropped from 30 seconds to less than 2 seconds on his 1700 content page sized blog.
He should now be able to add an improved version of that “Related Content” section without giving up the fast live-reloads. But it’s worth noting that:
If you don’t use any of the Related methods, you will not use the Relate Content feature, and performance will be the same as before.
Calling .RegularPages.Related etc. will create one inverted index, also sometimes named posting list, that will be reused for any lookups in that same page collection. Doing that in addition to, as an example, calling .Pages.Related will work as expected, but will create one additional inverted index. This should still be very fast, but worth having in mind, especially for bigger sites.