Skip to main content
Related pages display a list of links at the bottom of each documentation page, helping users discover relevant content they might not find through navigation alone.
To use related pages, enable them from the Add-ons page in your dashboard.

​
Modes

Related pages support two modes: automatic and manual.

​
Automatic

Automatic mode uses search to find and display pages related to the current page’s content. This mode requires no additional configuration beyond enabling the feature. When automatic mode is active, Mintlify analyzes the page title and matches it against your documentation to surface the most relevant pages. Results are scoped to the same language and version as the current page.

​
Manual

Manual mode only shows related pages that you explicitly define in frontmatter. Use this mode when you want full control over which pages appear as related content. In manual mode, pages without a relatedPages frontmatter property do not display any related pages. Enable and configure related pages from the Add-ons page in your dashboard. You can:
  • Toggle related pages on or off
  • Choose between automatic and manual mode
  • Set the maximum number of related pages to display (up to 10, default is 5)

​
Frontmatter overrides

Use the relatedPages frontmatter property to override the dashboard configuration on individual pages. This works in both automatic and manual modes. Specify a list of internal paths or external URLs to display as related pages: 
---
title: "Authentication"
relatedPages:
  - /security/api-keys
  - /security/oauth
  - https://example.com/external-guide
---
Internal paths resolve their titles and icons automatically from your navigation configuration. External URLs display the URL as the title.

​
Set explicit titles

Provide a custom title for any related page by using the Title: path format: 
---
title: "Authentication"
relatedPages:
  - Getting started with API keys: /security/api-keys
  - OAuth setup guide: /security/oauth
  - External reference: https://example.com/external-guide
---

​
Disable related pages on a specific page

Set relatedPages to false to hide related pages on a specific page, even when the feature is enabled globally: 
---
title: "Changelog"
relatedPages: false
---
Frontmatter-defined related pages are limited to a maximum of 10 entries.