Búsqueda

Configura la barra de búsqueda integrada de tu sitio Mintlify, incluidos los boosts de clasificación y el número de resultados devueltos por consulta.

Configura cómo se comporta la barra de búsqueda en tu sitio de documentación alojado en Mintlify. Estos ajustes solo afectan a la búsqueda integrada. No cambian cómo los motores de búsqueda externos indexan tus páginas.

​

Aumentar la clasificación de búsqueda

Usa boost para sesgar la clasificación de la búsqueda integrada en páginas o secciones específicas. El valor es un multiplicador numérico aplicado a la puntuación de relevancia de cada fragmento: boost: 3 hace que un fragmento sea tres veces más relevante de lo que sería sin un boost.

​

Aumentar una sola página

Configura boost en el frontmatter de una página para multiplicar su clasificación de búsqueda.

---
title: "Custom domain"
description: "Connect your custom domain to your Mintlify documentation."
boost: 3
---

​

Aumentar un grupo de navegación

Configura boost en un grupo dentro de la navegación de tu docs.json para aplicar el multiplicador a cada página que contiene.

{
  "navigation": {
    "groups": [
      {
        "group": "Get started",
        "boost": 5,
        "pages": [
          "quickstart",
          "concepts"
        ]
      }
    ]
  }
}

Una página hereda el factor de boost del ancestro más cercano que lo establece. Una página secundaria o un grupo anidado puede sobrescribir el boost heredado configurando su propio valor de boost. El boost del frontmatter de una página siempre prevalece sobre un valor heredado de la navegación.

​

Despriorizar contenido

Usa un valor inferior a 1 para empujar las páginas más abajo en los resultados de búsqueda. Por ejemplo, boost: 0.5 reduce a la mitad la puntuación de relevancia de una página en relación con otras páginas. Un boost de 1 equivale a no aplicar boost.

---
title: "Deprecated API"
description: "Documentation for the deprecated v1 API."
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.

​

Rango de boost recomendado

boost acepta cualquier número positivo. En la práctica, mantén los valores entre 0.1 y 10:

• 0.1–0.9: despriorizar contenido heredado, obsoleto o complementario.
• 1: sin cambios (equivalente a omitir boost).
• 2–5: priorizar una página de aterrizaje clave, una guía de inicio rápido o una referencia muy visitada.
• 5–10: reservar para un puñado de páginas de nivel superior que casi siempre deberían aparecer primero.

Evita valores superiores a 10. Los multiplicadores muy grandes desbordan la puntuación de relevancia subyacente y hacen que las páginas con boost aparezcan incluso cuando no coinciden bien con la consulta.

​

Excluir una página de la búsqueda

Las páginas son buscables de forma predeterminada. El campo searchable es opcional y su valor predeterminado es true. Establece searchable: false en el frontmatter de una página para excluirla de los resultados de búsqueda de tu sitio de documentación. searchable es un campo solo a nivel de página: para excluir todas las páginas de una pestaña o grupo de navegación, oculta la pestaña o el grupo en su lugar. Consulta Páginas ocultas para conocer los controles a nivel de pestaña y grupo.

---
title: "Notas internas"
description: "Material de referencia que no queremos que aparezca en la búsqueda."
searchable: false
---

A diferencia de noindex, searchable: false no afecta el SEO externo. La página sigue:

• Siendo rastreable por motores de búsqueda externos
• Listada en tu sitemap.xml

Se excluye de los resultados de búsqueda de tu sitio de documentación y del contexto del asistente de IA.

Usa searchable: false para páginas que deben seguir accesibles mediante enlaces directos o motores de búsqueda externos, pero que no deberían aparecer cuando los usuarios buscan dentro de tus docs. Es útil para páginas de referencia detalladas, contenido heredado o material de apoyo que de otro modo desplazaría resultados más relevantes.

Para excluir una página tanto de la búsqueda integrada como de la indexación externa, usa noindex: true en su lugar.

​

Máximo de resultados de búsqueda

Controla cuántos resultados devuelve la barra de búsqueda por consulta desde tu dashboard. El valor predeterminado es 6 resultados. Puedes establecer cualquier valor entre 1 y 100.

En tu dashboard, ve a Settings > Deployment > Search, establece Maximum search results en el valor que quieras y selecciona Save changes.

Los valores más altos muestran más coincidencias por consulta, lo cual es útil para sitios con una cobertura temática amplia donde los usuarios esperan revisar muchos candidatos. Los valores más bajos mantienen compacto el panel de resultados y dirigen a los usuarios hacia la coincidencia mejor clasificada.