# Related topics (/organize/related-pages)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 765 · updated: 2026-07-30 -->
Related: [Hidden pages](/organize/hidden-pages.md), [Exclude files from publishing](/organize/mintignore.md), [Navigation](/organize/navigation.md), [Pages](/organize/pages.md)

Add related topics to the bottom of each page to help readers discover relevant content. Suggested pages can come from automated recommendations, from links you curate in page frontmatter, or from a mix of both.

## Enable related topics [#enable-related-topics]

1. Navigate to the [Add-ons](https://app.mintlify.com/settings/deployment/addons) page in your dashboard.
2. In the "Related topics" section, enable **Show related topics**.
3. Select a mode and, optionally, set a limit on how many pages to show.

## Modes [#modes]

<ResponseField name="Automatic" type="mode">
  Mintlify generates suggestions from your contents' search index using the current page's title. Frontmatter overrides still take precedence over automatic suggestions. Use this mode when you want related pages to update automatically as you add content.
</ResponseField>

<ResponseField name="Manual" type="mode">
  Only pages listed in a page's `related` frontmatter are shown. Pages without a `related` field display no **Related topics** section. Use this mode when you want full editorial control.
</ResponseField>

### Limit [#limit]

Set how many related pages to display. The default is `5` and the maximum is `10`.

## Configure per page with frontmatter [#configure-per-page-with-frontmatter]

Use the `related` frontmatter field to override or supply the list of related pages for a single page. This works in both **Automatic** and **Manual** modes.

<ResponseField name="related" type="array | false">
  A list of related pages, or `false` to hide the **Related topics** section on this page.

  Each entry can be:

  * A root-relative path to another page in your docs: `/api-playground/overview`
  * An absolute URL to an external site: `https://example.com/docs`
  * A `Title: link` object to set an explicit label

  If you don't explicitly set titles and icons for internal paths, Mintlify infers them. External links open in a new tab.
</ResponseField>

### Examples [#examples]

Curate a list of internal pages:

```mdx
---
title: "Authentication"
related:
  - /api-playground/overview
  - /deploy/authentication-setup
  - /organize/hidden-pages
---
```

Mix internal pages, external links, and custom titles:

```mdx
---
title: "Authentication"
related:
  - Overview: /api-playground/overview
  - Set up auth: /deploy/authentication-setup
  - OAuth 2.0 spec: https://oauth.net/2/
---
```

Hide the **Related topics** section on a specific page:

```mdx
---
title: "Changelog"
related: false
---
```

## How suggestions are generated [#how-suggestions-are-generated]

In **Automatic** mode, related pages are generated from your docs' search index using the current page's title as the query. Results are filtered by the page's language and version when applicable, and the current page is excluded.

For deployments with [end-user authentication](/deploy/authentication-setup), automatic suggestions are disabled to avoid leaking content across user contexts. Use the `related` frontmatter field to show curated suggestions on user-authenticated deployments.