1. Documentation
  2. Components
  3. Related Topics
ReadmeGitHub
  • Introduction
  • Quickstart
  • Text
  • Code
  • Lists
  • Tables
  • Accordion
  • Badge
  • Button
  • Callout
  • Code Block
  • Code Block Group
  • Code Snippet
  • Columns
  • Custom components
  • GitHub
  • Hover Card
  • Mermaid
  • Properties
  • Related Topics
  • Tabs
  • Tree
  • Images
  • Video
  • Files
  • Grain
  • Shade
  • Moss
  • Configuration
  • Content
  • Navigation
  • Site Identity
  • Appearance
  • Header and Footer
  • Fonts
  • Icons
  • Integrations
  • Search
  • OpenAPI
  • AI Chat
  • React Router
  • Astro
  • Next.js
  • Cloudflare
  • Vercel
  • robots.txt
  • sitemap.xml
  • JSON-LD
  • rss.xml
  • llms.txt
  • llms-full.txt
  • .md endpoints

Related Topics

Guide readers to adjacent documentation with a compact, linked topic list.

Loading documentation…

Properties< PreviousTabsNext >

Powered by heyo

On this page

When to use itCustom heading and external linksCurate an implementation bundleProperties

Related topics

  • Start building your first documentation site
  • Create interactive code snippets in MDX
  • Read the shadcn Hover Card documentation
<RelatedTopics><RelatedTopic  icon="book"  name="Start building your first documentation site"  src="https://heyo.sh/heyo-docs/quickstart"/><RelatedTopic  icon="code"  name="Create interactive code snippets in MDX"  src="https://heyo.sh/heyo-docs/components/code-snippet"/><RelatedTopic  icon="globe"  name="Read the shadcn Hover Card documentation"  src="https://ui.shadcn.com/docs/components/base/hover-card"/></RelatedTopics>

RelatedTopics creates a compact list of useful next pages, while RelatedTopic renders each row. It is a focused alternative to repeating inline links throughout a page: readers can finish the current explanation, then choose a logical next topic from one predictable place.

When to use it

Use this component near the end of a guide, reference page, or conceptual overview to point to pages a reader is likely to need next. It is especially helpful for sibling concepts, optional deep dives, prerequisites that do not belong in the main flow, and links to external references.

Prefer three to five genuinely relevant destinations. A long list behaves like another navigation menu and makes it harder to choose a next step. Keep the label action-oriented and specific, such as Configure navigation rather than More information.

Relative src values stay in the documentation site. Full URLs are recognised as external links and open in a new tab with noreferrer. Omitting src renders a non-clickable row, which is useful for showing an unavailable or upcoming topic but should be the exception.

Custom heading and external links

Continue learning

  • Browse the MDX components
  • View the Base UI Preview Card documentation

Curate an implementation bundle

Related topics can also close an overview page: use a focused heading and three well-chosen destinations to give a reader an obvious route through the work.

Build your launch checklist

  • Create reusable MDX components
  • Make every page easy to find
  • Deploy a production-ready site
<RelatedTopics title="Build your launch checklist"><RelatedTopic  icon="code"  name="Create reusable MDX components"  src="https://heyo.sh/heyo-docs/components/custom-components"/><RelatedTopic  icon="search"  name="Make every page easy to find"  src="https://heyo.sh/heyo-docs/manage-website/search"/><RelatedTopic  icon="arrowRight"  name="Deploy a production-ready site"  src="https://heyo.sh/heyo-docs/deploying/vercel"/></RelatedTopics>

Properties

titleReactNodeoptional

A RelatedTopics heading. It defaults to Related topics. Supply a short title such as Continue learning when the links represent a particular next action.

childrenRelatedTopic[]optional

The topic rows to display. Place RelatedTopic elements directly inside the list so the component can preserve its accessible list structure.

classNamestringoptional

Extra classes for the outer RelatedTopics section.

nameReactNodeoptional

A RelatedTopic label. If it is omitted, the component uses the topic's children as the label.

srcstringoptional

A RelatedTopic destination. Relative paths render as normal documentation links; absolute URLs render as external links in a new tab. Omit it to render a static, non-clickable row.

iconstringoptional

A RelatedTopic icon name. It defaults to book. Choose a name from the configured Heyo Docs icon set that matches the destination's purpose.

childrenReactNodeoptional

Fallback content for an individual RelatedTopic when name is not set.