Related Article

Hugo provides a built-in related article feature powered by an inverted index algorithm. This mechanism offers high performance, though its reliance on exact string matching requires specific taxonomy strategies to achieve optimal results.

Principle

The system operates by indexing taxonomies (tags) and dates. It calculates similarity scores based on term overlap between the current page and other pages in the site.

The core logic follows a two-stage process¹:

1. Pre-processing: The engine extracts terms from all pages, maps them to their respective documents, and filters out high-frequency terms based on the cardinalityThreshold.
2. Calculation: It retrieves terms from the current page, looks up matching documents in the index, and applies weight-based scoring. Pages falling below the threshold are excluded.

Limitations

The effectiveness of this system depends on consistent taxonomy management:

• Taxonomy Precision: Results require precise control over tags. Unique tags may fail to form relationships, while overly generic terms may be discarded as noise by the algorithm.
• Manual Synchronization: Requires manual terminology alignment across all articles to ensure the exact string matching logic functions as intended.

Configuration

The system utilizes Hugo's default weight settings unless explicitly defined. For custom weighting and indexing rules, refer to the Hugo Related Content Documentation.