Skip to main content

Related Topics

The Related Topics component automatically suggests related content based on shared taxonomy tags. It analyzes the current page's tags and finds other documents with similar tags, then displays them as a curated list of recommendations.

  1. Select Related Topics from the Embed list.
  2. Edit the component.
  3. (Optional) Set the Maximum Results to control how many related topics are displayed (defaults to 5).
  4. Save your changes.

Configuration Options​

  • Maximum Results: Controls the number of related topics displayed (1-20)

How It Works​

The component uses the Jaccard similarity algorithm to compare taxonomy tags between the current page and all other published pages. Pages with more shared tags will appear higher in the list. The component only appears on pages that have taxonomy tags and when related content is found.

Best Practices​

  • Use consistent tagging: The more consistently you apply taxonomy tags across your content, the better the related topic suggestions will be.
  • Optimal placement: Place the Related Topics component at the end of your content to encourage further reading.
  • Reasonable limits: Use 3-7 related topics for best user experience. Too many suggestions can be overwhelming.

Related topics

  • Footnotes – Automatically numbered and back-linked footnotes.
  • Tabs – Using tabs in docStatic.
  • Create a doc – Create a Markdown document.
  • Creating pages – Creating pages in the CMS.
  • Markdown features – DocStatic uses MDX. Find out more about docStatic-specific features when writing Markdown.
  • Figures – Images with captions and lightbox zoom.
  • Hosted CMS – Using docStatic with cloud-hosted or self-hosted TinaCMS.