diff --git a/docs.json b/docs.json
index 081e918b7..3afe28380 100644
--- a/docs.json
+++ b/docs.json
@@ -63,6 +63,7 @@
"organize/navigation",
"organize/pages",
"organize/hidden-pages",
+ "organize/related-pages",
"organize/mintignore"
]
},
diff --git a/es.json b/es.json
index 649bd0d26..dd01c3fc4 100644
--- a/es.json
+++ b/es.json
@@ -41,6 +41,7 @@
"es/organize/navigation",
"es/organize/pages",
"es/organize/hidden-pages",
+ "es/organize/related-pages",
"es/organize/mintignore"
]
},
diff --git a/es/organize/pages.mdx b/es/organize/pages.mdx
index e4ac33454..794ef3a73 100644
--- a/es/organize/pages.mdx
+++ b/es/organize/pages.mdx
@@ -81,6 +81,10 @@ Usa el frontmatter para controlar:
Establécelo en `true` para ocultar los enlaces de navegación de página anterior/siguiente en la parte inferior de la página. Úsalo para páginas independientes como páginas de destino o páginas de referencia donde la navegación secuencial no aplica.
+
+ Una lista de páginas relacionadas para mostrar en la sección **Temas relacionados** en la parte inferior de la página, o `false` para ocultar la sección por completo. Anula las sugerencias automáticas de la implementación. Requiere que el add-on [Páginas relacionadas](/es/organize/related-pages) esté habilitado. Consulta [Páginas relacionadas](/es/organize/related-pages) para más detalles.
+
+
Establécelo en `true` para ocultar la insignia del método HTTP (como GET o POST) junto al título de la página en la barra lateral. Úsalo para páginas de API donde desees una apariencia más limpia en la barra lateral.
diff --git a/es/organize/related-pages.mdx b/es/organize/related-pages.mdx
new file mode 100644
index 000000000..6dad99ad7
--- /dev/null
+++ b/es/organize/related-pages.mdx
@@ -0,0 +1,105 @@
+---
+title: "Páginas relacionadas"
+description: "Muestra una sección de Temas relacionados en la parte inferior de cada página con sugerencias automáticas basadas en búsqueda o enlaces seleccionados manualmente desde el frontmatter."
+keywords: ["relacionadas", "páginas relacionadas", "temas relacionados", "recomendaciones", "frontmatter"]
+---
+
+Las páginas relacionadas muestran una sección de **Temas relacionados** en la parte inferior de cada página de documentación, ayudando a los lectores a descubrir contenido conectado. Las sugerencias pueden provenir de recomendaciones basadas en búsqueda, de enlaces que seleccionas en el frontmatter de la página o de una combinación de ambos.
+
+
+ ## Habilitar páginas relacionadas
+
+
+Las páginas relacionadas son un add-on de la implementación. Habilítalo en tu panel:
+
+1. Abre tu panel y ve a **Configuración** > **Add-ons**.
+2. Encuentra **Temas relacionados** y actívalo.
+3. Elige un modo y, opcionalmente, establece un límite en cuántas páginas se muestran.
+
+
+ ## Modos
+
+
+
+ Las sugerencias se generan a partir del índice de búsqueda de tus documentos usando el título de la página actual. Las anulaciones en el frontmatter siguen teniendo prioridad cuando se configuran. Usa este modo cuando quieras que las páginas relacionadas se actualicen automáticamente a medida que agregas contenido.
+
+
+
+ Solo se muestran las páginas listadas en el frontmatter `related` de una página. Las páginas sin un campo `related` no muestran ninguna sección de **Temas relacionados**. Usa este modo cuando quieras control editorial total.
+
+
+
+ ### Límite
+
+
+Establece cuántas páginas relacionadas mostrar. El valor predeterminado es `5` y el máximo es `10`. El límite se aplica a las sugerencias automáticas; las entradas manuales están limitadas al máximo.
+
+
+ ## Configurar por página con frontmatter
+
+
+Usa el campo de frontmatter `related` para anular o proporcionar la lista de páginas relacionadas para una sola página. Esto funciona tanto en el modo **Automático** como en el **Manual**.
+
+
+ Una lista de páginas relacionadas, o `false` para ocultar la sección **Temas relacionados** en esta página.
+
+ Cada entrada puede ser:
+ - Una ruta relativa a la raíz de otra página en tus documentos: `/api-playground/overview`
+ - Una URL absoluta a un sitio externo: `https://example.com/docs`
+ - Un objeto `Title: link` para establecer una etiqueta explícita
+
+ Los títulos e íconos para las rutas internas se infieren de tu navegación cuando no se establecen explícitamente. Los enlaces externos se abren en una nueva pestaña.
+
+
+
+ ### Ejemplos
+
+
+Selecciona una lista de páginas internas:
+
+```mdx
+---
+title: "Authentication"
+related:
+ - /api-playground/overview
+ - /deploy/authentication-setup
+ - /organize/hidden-pages
+---
+```
+
+Combina páginas internas, enlaces externos y títulos personalizados:
+
+```mdx
+---
+title: "Authentication"
+related:
+ - Overview: /api-playground/overview
+ - Set up auth: /deploy/authentication-setup
+ - OAuth 2.0 spec: https://oauth.net/2/
+---
+```
+
+Oculta la sección **Temas relacionados** en una página específica:
+
+```mdx
+---
+title: "Changelog"
+related: false
+---
+```
+
+
+ ## Cómo se generan las sugerencias
+
+
+En el modo **Automático**, las páginas relacionadas se generan a partir del índice de búsqueda de tus documentos usando el título de la página actual como consulta. Los resultados se filtran por el idioma y la versión de la página cuando corresponde, y la página actual se excluye.
+
+Para las implementaciones con [autenticación de usuario final](/es/deploy/authentication-setup), las sugerencias automáticas están deshabilitadas para evitar filtrar contenido entre contextos de usuario. Usa el campo de frontmatter `related` para mostrar sugerencias seleccionadas en implementaciones autenticadas por usuario.
+
+
+ ## Recursos relacionados
+
+
+- [Páginas](/es/organize/pages): Configura los metadatos de la página con frontmatter.
+- [Enlaces](/es/guides/linking): Mejores prácticas para conectar páginas entre sí.
+- [Búsqueda](/es/optimize/search): Configura cómo se clasifican y filtran los resultados de búsqueda.
diff --git a/fr.json b/fr.json
index daef36f58..98ef8cfbe 100644
--- a/fr.json
+++ b/fr.json
@@ -41,6 +41,7 @@
"fr/organize/navigation",
"fr/organize/pages",
"fr/organize/hidden-pages",
+ "fr/organize/related-pages",
"fr/organize/mintignore"
]
},
diff --git a/fr/organize/pages.mdx b/fr/organize/pages.mdx
index d10acd26b..84ffcecab 100644
--- a/fr/organize/pages.mdx
+++ b/fr/organize/pages.mdx
@@ -81,6 +81,10 @@ Utilisez le frontmatter pour contrôler :
Définir sur `true` pour masquer les liens de navigation page précédente/page suivante en bas de la page. Utilisez cette option pour les pages autonomes telles que les pages de destination ou les pages de référence où la navigation séquentielle ne s'applique pas.
+
+ Une liste de pages associées à afficher dans la section **Sujets associés** en bas de la page, ou `false` pour masquer entièrement la section. Remplace les suggestions automatiques du déploiement. Nécessite l'activation du module complémentaire [Pages associées](/fr/organize/related-pages). Voir [Pages associées](/fr/organize/related-pages) pour plus de détails.
+
+
Définir sur `true` pour masquer le badge de méthode HTTP (tel que GET ou POST) à côté du titre de la page dans la barre latérale. Utilisez cette option pour les pages d'API lorsque vous souhaitez une apparence plus épurée de la barre latérale.
diff --git a/fr/organize/related-pages.mdx b/fr/organize/related-pages.mdx
new file mode 100644
index 000000000..0acc34f26
--- /dev/null
+++ b/fr/organize/related-pages.mdx
@@ -0,0 +1,105 @@
+---
+title: "Pages associées"
+description: "Affichez une section Sujets associés en bas de chaque page avec des suggestions automatiques basées sur la recherche ou des liens sélectionnés manuellement depuis le frontmatter."
+keywords: ["associées", "pages associées", "sujets associés", "recommandations", "frontmatter"]
+---
+
+Les pages associées font apparaître une section **Sujets associés** en bas de chaque page de documentation, aidant les lecteurs à découvrir du contenu connexe. Les suggestions peuvent provenir de recommandations basées sur la recherche, de liens que vous sélectionnez dans le frontmatter de la page, ou d'un mélange des deux.
+
+
+ ## Activer les pages associées
+
+
+Les pages associées sont un module complémentaire de déploiement. Activez-le dans votre tableau de bord :
+
+1. Ouvrez votre tableau de bord et accédez à **Paramètres** > **Modules complémentaires**.
+2. Trouvez **Sujets associés** et activez l'option.
+3. Choisissez un mode et, éventuellement, définissez une limite du nombre de pages affichées.
+
+
+ ## Modes
+
+
+
+ Les suggestions sont générées à partir de l'index de recherche de votre documentation en utilisant le titre de la page en cours. Les remplacements via le frontmatter restent prioritaires lorsqu'ils sont définis. Utilisez ce mode lorsque vous souhaitez que les pages associées se mettent à jour automatiquement à mesure que vous ajoutez du contenu.
+
+
+
+ Seules les pages listées dans le champ `related` du frontmatter d'une page sont affichées. Les pages sans champ `related` n'affichent aucune section **Sujets associés**. Utilisez ce mode lorsque vous souhaitez un contrôle éditorial complet.
+
+
+
+ ### Limite
+
+
+Définissez le nombre de pages associées à afficher. La valeur par défaut est `5` et la valeur maximale est `10`. La limite s'applique aux suggestions automatiques ; les entrées manuelles sont plafonnées à la valeur maximale.
+
+
+ ## Configurer par page avec le frontmatter
+
+
+Utilisez le champ de frontmatter `related` pour remplacer ou fournir la liste des pages associées pour une seule page. Cela fonctionne à la fois en mode **Automatic** et en mode **Manual**.
+
+
+ Une liste de pages associées, ou `false` pour masquer la section **Sujets associés** sur cette page.
+
+ Chaque entrée peut être :
+ - Un chemin relatif à la racine vers une autre page de votre documentation : `/api-playground/overview`
+ - Une URL absolue vers un site externe : `https://example.com/docs`
+ - Un objet `Title: link` pour définir un libellé explicite
+
+ Les titres et icônes des chemins internes sont déduits de votre navigation lorsqu'ils ne sont pas définis explicitement. Les liens externes s'ouvrent dans un nouvel onglet.
+
+
+
+ ### Exemples
+
+
+Sélectionnez une liste de pages internes :
+
+```mdx
+---
+title: "Authentication"
+related:
+ - /api-playground/overview
+ - /deploy/authentication-setup
+ - /organize/hidden-pages
+---
+```
+
+Mélangez pages internes, liens externes et titres personnalisés :
+
+```mdx
+---
+title: "Authentication"
+related:
+ - Overview: /api-playground/overview
+ - Set up auth: /deploy/authentication-setup
+ - OAuth 2.0 spec: https://oauth.net/2/
+---
+```
+
+Masquez la section **Sujets associés** sur une page spécifique :
+
+```mdx
+---
+title: "Changelog"
+related: false
+---
+```
+
+
+ ## Comment les suggestions sont générées
+
+
+En mode **Automatic**, les pages associées sont générées à partir de l'index de recherche de votre documentation en utilisant le titre de la page en cours comme requête. Les résultats sont filtrés selon la langue et la version de la page, le cas échéant, et la page en cours est exclue.
+
+Pour les déploiements avec [authentification des utilisateurs finaux](/fr/deploy/authentication-setup), les suggestions automatiques sont désactivées afin d'éviter les fuites de contenu entre contextes utilisateur. Utilisez le champ de frontmatter `related` pour afficher des suggestions sélectionnées sur les déploiements avec authentification utilisateur.
+
+
+ ## Ressources associées
+
+
+- [Pages](/fr/organize/pages) : Configurez les métadonnées de page avec le frontmatter.
+- [Création de liens](/fr/guides/linking) : Bonnes pratiques pour relier les pages entre elles.
+- [Recherche](/fr/optimize/search) : Configurez la façon dont les résultats de recherche sont classés et filtrés.
diff --git a/organize/pages.mdx b/organize/pages.mdx
index 2afddd995..8fc8f61ec 100644
--- a/organize/pages.mdx
+++ b/organize/pages.mdx
@@ -78,6 +78,10 @@ Use frontmatter to control:
Set to `true` to hide the previous/next page navigation links at the bottom of the page. Use this for standalone pages like landing pages or reference pages where sequential navigation does not apply.
+
+ A list of related pages to show in the **Related topics** section at the bottom of the page, or `false` to hide the section entirely. Overrides the deployment's automatic suggestions. Requires enabling the [Related pages](/organize/related-pages) add-on.
+
+
Set to `true` to hide the HTTP method badge (such as GET or POST) next to the page title in the sidebar. Use this for API pages where you want a cleaner sidebar appearance.
diff --git a/organize/related-pages.mdx b/organize/related-pages.mdx
new file mode 100644
index 000000000..d72982469
--- /dev/null
+++ b/organize/related-pages.mdx
@@ -0,0 +1,84 @@
+---
+title: "Related topics"
+description: "Add links to related pages at the bottom of each page with automatic suggestions or manually curated links from frontmatter."
+keywords: ["related", "related pages", "related topics", "recommendations", "frontmatter"]
+---
+
+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
+
+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. Choose a mode and, optionally, set a limit on how many pages are shown.
+
+## Modes
+
+
+ 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.
+
+
+
+ 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.
+
+
+### Limit
+
+Set how many related pages to display. The default is `5` and the maximum is `10`.
+
+## 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.
+
+
+ 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.
+
+
+### 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
+
+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.
+
diff --git a/zh.json b/zh.json
index 117eec8f4..85ea81f54 100644
--- a/zh.json
+++ b/zh.json
@@ -41,6 +41,7 @@
"zh/organize/navigation",
"zh/organize/pages",
"zh/organize/hidden-pages",
+ "zh/organize/related-pages",
"zh/organize/mintignore"
]
},
diff --git a/zh/organize/pages.mdx b/zh/organize/pages.mdx
index 253da1e98..0fbb7db90 100644
--- a/zh/organize/pages.mdx
+++ b/zh/organize/pages.mdx
@@ -81,6 +81,10 @@ boost: 3
设为 `true` 可隐藏页面底部的上一页/下一页导航链接。适用于落地页或参考页等不需要顺序导航的独立页面。
+
+ 要在页面底部 **相关主题** 部分显示的相关页面列表，或设为 `false` 以完全隐藏该部分。此字段会覆盖部署的自动推荐。需要启用 [相关页面](/zh/organize/related-pages) add-on。详情参见 [相关页面](/zh/organize/related-pages)。
+
+
设为 `true` 可隐藏侧边栏中页面标题旁的 HTTP 方法标记（如 GET 或 POST）。适用于希望侧边栏外观更简洁的 API 页面。
diff --git a/zh/organize/related-pages.mdx b/zh/organize/related-pages.mdx
new file mode 100644
index 000000000..23e56c91f
--- /dev/null
+++ b/zh/organize/related-pages.mdx
@@ -0,0 +1,105 @@
+---
+title: "相关页面"
+description: "在每个页面底部显示“相关主题”部分，展示基于搜索的自动推荐或从 frontmatter 中手动整理的链接。"
+keywords: ["相关", "相关页面", "相关主题", "推荐", "frontmatter"]
+---
+
+相关页面会在每个文档页面底部呈现一个 **相关主题** 部分，帮助读者发现相互关联的内容。推荐来源可以是基于搜索的自动建议，也可以是你在页面 frontmatter 中整理的链接，或两者的组合。
+
+
+ ## 启用相关页面
+
+
+相关页面是一项部署 add-on。请在你的仪表盘中启用它：
+
+1. 打开仪表盘并进入 **设置** > **Add-ons**。
+2. 找到 **相关主题** 并将其开启。
+3. 选择一种模式，并根据需要设置显示页面数量的上限。
+
+
+ ## 模式
+
+
+
+ 基于当前页面的标题，从你文档的搜索索引中生成推荐。当页面中设置了 frontmatter 覆盖时，仍以 frontmatter 为准。当你希望相关页面在新增内容时自动更新时，请使用此模式。
+
+
+
+ 仅显示页面 `related` frontmatter 中列出的页面。没有 `related` 字段的页面不会显示 **相关主题** 部分。当你希望完全掌控编辑内容时，请使用此模式。
+
+
+
+ ### 数量上限
+
+
+设置要显示的相关页面数量。默认值为 `5`，最大值为 `10`。该上限适用于自动推荐；手动条目也以最大值为上限。
+
+
+ ## 通过 frontmatter 按页配置
+
+
+使用 `related` frontmatter 字段可以覆盖或直接为某个页面提供相关页面列表。此字段在 **Automatic** 和 **Manual** 两种模式下均可使用。
+
+
+ 相关页面列表，或设为 `false` 以隐藏该页面的 **相关主题** 部分。
+
+ 每个条目可以是：
+ - 指向文档中另一个页面的根相对路径：`/api-playground/overview`
+ - 指向外部站点的绝对 URL：`https://example.com/docs`
+ - 用于设置显式标签的 `Title: link` 对象
+
+ 当未显式设置时，内部路径的标题和图标会从你的导航中推断得到。外部链接会在新标签页中打开。
+
+
+
+ ### 示例
+
+
+整理一组内部页面：
+
+```mdx
+---
+title: "Authentication"
+related:
+ - /api-playground/overview
+ - /deploy/authentication-setup
+ - /organize/hidden-pages
+---
+```
+
+混合使用内部页面、外部链接和自定义标题：
+
+```mdx
+---
+title: "Authentication"
+related:
+ - Overview: /api-playground/overview
+ - Set up auth: /deploy/authentication-setup
+ - OAuth 2.0 spec: https://oauth.net/2/
+---
+```
+
+在特定页面上隐藏 **相关主题** 部分：
+
+```mdx
+---
+title: "Changelog"
+related: false
+---
+```
+
+
+ ## 推荐是如何生成的
+
+
+在 **Automatic** 模式下，相关页面基于你文档的搜索索引，将当前页面的标题作为查询条件生成。结果会按照页面的语言和版本（如适用）进行过滤，且会排除当前页面。
+
+对于启用了[终端用户认证](/zh/deploy/authentication-setup)的部署，自动推荐会被禁用，以避免跨用户上下文泄露内容。在启用了用户认证的部署上，请使用 `related` frontmatter 字段来展示经过整理的推荐。
+
+
+ ## 相关资源
+
+
+- [页面](/zh/organize/pages)：使用 frontmatter 配置页面元数据。
+- [链接](/zh/guides/linking)：连接页面的最佳实践。
+- [搜索](/zh/optimize/search)：配置搜索结果的排序和过滤方式。