From 0eea7446636a219ba7a7a8188cb56d596f2584b5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 16 May 2026 20:44:38 +0000 Subject: [PATCH 1/2] docs: document per-deployment search max results setting --- es/optimize/search-boost.mdx | 8 ++++++++ fr/optimize/search-boost.mdx | 8 ++++++++ optimize/search-boost.mdx | 8 ++++++++ zh/optimize/search-boost.mdx | 8 ++++++++ 4 files changed, 32 insertions(+) diff --git a/es/optimize/search-boost.mdx b/es/optimize/search-boost.mdx index d3a2900e55..fd942a6336 100644 --- a/es/optimize/search-boost.mdx +++ b/es/optimize/search-boost.mdx @@ -64,3 +64,11 @@ boost: 0.25 Los factores de boost se combinan con la puntuación de relevancia existente. Úsalos con moderación. Multiplicadores grandes pueden hacer que páginas menos relevantes dominen los resultados de búsqueda y degraden la calidad general de la búsqueda. + +## Establecer el número máximo de resultados de búsqueda + +Controla cuántos resultados devuelve la barra de búsqueda integrada configurando **Max results** en tu panel, en **Settings > Search**. El valor debe ser un entero entre `1` y `100`. Por defecto, Mintlify devuelve hasta seis resultados. + +Aumenta este valor cuando tu documentación cubra muchos temas adyacentes y los usuarios se beneficien de ver más coincidencias a la vez. Redúcelo para mantener la lista de resultados enfocada y disminuir el ruido visual. + +Esta configuración solo afecta a la barra de búsqueda de tu sitio de documentación alojado en Mintlify. La [API de búsqueda](/es/api/assistant/search) sigue respetando el parámetro `pageSize` de cada solicitud, que tiene prioridad sobre la configuración del panel cuando se proporciona. diff --git a/fr/optimize/search-boost.mdx b/fr/optimize/search-boost.mdx index 56cd8ee67b..34fd2375ad 100644 --- a/fr/optimize/search-boost.mdx +++ b/fr/optimize/search-boost.mdx @@ -64,3 +64,11 @@ boost: 0.25 Les facteurs de boost se combinent avec le score de pertinence existant. Utilisez-les avec parcimonie. Des multiplicateurs élevés peuvent faire en sorte que des pages moins pertinentes dominent les résultats de recherche et dégradent la qualité globale de la recherche. + +## Définir le nombre maximal de résultats de recherche + +Contrôlez le nombre de résultats renvoyés par la barre de recherche intégrée en définissant **Max results** dans votre tableau de bord, sous **Settings > Search**. La valeur doit être un entier compris entre `1` et `100`. Par défaut, Mintlify renvoie jusqu'à six résultats. + +Augmentez cette valeur lorsque votre documentation couvre de nombreux sujets connexes et que les utilisateurs gagnent à voir davantage de correspondances à la fois. Réduisez-la pour garder la liste de résultats ciblée et limiter le bruit visuel. + +Ce paramètre n'affecte que la barre de recherche de votre site de documentation hébergé par Mintlify. L'[API de recherche](/fr/api/assistant/search) continue de respecter le paramètre `pageSize` de chaque requête, qui l'emporte sur le paramètre du tableau de bord lorsqu'il est fourni. diff --git a/optimize/search-boost.mdx b/optimize/search-boost.mdx index e14b636cce..07e72fc4b9 100644 --- a/optimize/search-boost.mdx +++ b/optimize/search-boost.mdx @@ -58,3 +58,11 @@ boost: 0.25 Boost factors compose with the existing relevance score. Use them sparingly. Large multipliers can cause less-relevant pages to dominate search results and degrade overall search quality. + +## Set the maximum number of search results + +Control how many results your in-product search bar returns by setting **Max results** in your dashboard under **Settings > Search**. The value must be an integer between `1` and `100`. Mintlify returns up to six results by default. + +Increase this value when your documentation covers many adjacent topics and users benefit from seeing more matches at once. Lower it to keep the results list focused and reduce visual noise. + +This setting only affects the search bar on your Mintlify-hosted documentation site. The [Search API](/api/assistant/search) continues to honor the `pageSize` parameter on each request, which overrides the dashboard setting when provided. diff --git a/zh/optimize/search-boost.mdx b/zh/optimize/search-boost.mdx index 5639b62928..f343c85711 100644 --- a/zh/optimize/search-boost.mdx +++ b/zh/optimize/search-boost.mdx @@ -64,3 +64,11 @@ boost: 0.25 加权因子会与已有的相关性得分相乘。请谨慎使用。过大的乘数会导致相关性较低的页面在搜索结果中占据主导地位，从而降低整体搜索质量。 + +## 设置搜索结果数量上限 + +在仪表盘的 **Settings > Search** 中设置 **Max results**，以控制站内搜索栏返回的结果数量。该值必须是介于 `1` 到 `100` 之间的整数。默认情况下，Mintlify 最多返回六条结果。 + +如果你的文档涵盖许多相邻主题，并且用户能从一次性看到更多匹配中获益，可以提高此值。如果想让结果列表更聚焦、减少视觉干扰，则降低此值。 + +该设置仅影响 Mintlify 托管文档站点上的搜索栏。[搜索 API](/zh/api/assistant/search) 仍会遵循每个请求中的 `pageSize` 参数，当显式传入时优先级高于仪表盘设置。 From 48003659058ae82e5d5798a74c10bfeb968b76ea Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 16 May 2026 20:46:31 +0000 Subject: [PATCH 2/2] docs: wrap translated headings with anchor div for shared link compatibility --- es/optimize/search-boost.mdx | 4 +++- fr/optimize/search-boost.mdx | 4 +++- zh/optimize/search-boost.mdx | 4 +++- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/es/optimize/search-boost.mdx b/es/optimize/search-boost.mdx index fd942a6336..dc5723047e 100644 --- a/es/optimize/search-boost.mdx +++ b/es/optimize/search-boost.mdx @@ -65,7 +65,9 @@ boost: 0.25 Los factores de boost se combinan con la puntuación de relevancia existente. Úsalos con moderación. Multiplicadores grandes pueden hacer que páginas menos relevantes dominen los resultados de búsqueda y degraden la calidad general de la búsqueda. -## Establecer el número máximo de resultados de búsqueda +
+ ## Establecer el número máximo de resultados de búsqueda +
Controla cuántos resultados devuelve la barra de búsqueda integrada configurando **Max results** en tu panel, en **Settings > Search**. El valor debe ser un entero entre `1` y `100`. Por defecto, Mintlify devuelve hasta seis resultados. diff --git a/fr/optimize/search-boost.mdx b/fr/optimize/search-boost.mdx index 34fd2375ad..505f6a781e 100644 --- a/fr/optimize/search-boost.mdx +++ b/fr/optimize/search-boost.mdx @@ -65,7 +65,9 @@ boost: 0.25 Les facteurs de boost se combinent avec le score de pertinence existant. Utilisez-les avec parcimonie. Des multiplicateurs élevés peuvent faire en sorte que des pages moins pertinentes dominent les résultats de recherche et dégradent la qualité globale de la recherche. -## Définir le nombre maximal de résultats de recherche +
+ ## Définir le nombre maximal de résultats de recherche +
Contrôlez le nombre de résultats renvoyés par la barre de recherche intégrée en définissant **Max results** dans votre tableau de bord, sous **Settings > Search**. La valeur doit être un entier compris entre `1` et `100`. Par défaut, Mintlify renvoie jusqu'à six résultats. diff --git a/zh/optimize/search-boost.mdx b/zh/optimize/search-boost.mdx index f343c85711..a21f0603d3 100644 --- a/zh/optimize/search-boost.mdx +++ b/zh/optimize/search-boost.mdx @@ -65,7 +65,9 @@ boost: 0.25 加权因子会与已有的相关性得分相乘。请谨慎使用。过大的乘数会导致相关性较低的页面在搜索结果中占据主导地位，从而降低整体搜索质量。 -## 设置搜索结果数量上限 +
+ ## 设置搜索结果数量上限 +
在仪表盘的 **Settings > Search** 中设置 **Max results**，以控制站内搜索栏返回的结果数量。该值必须是介于 `1` 到 `100` 之间的整数。默认情况下，Mintlify 最多返回六条结果。