> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# SEO
> Configura meta tags, propiedades Open Graph, URLs canónicas y ajustes SEO por página para mejorar el posicionamiento de tu documentación en motores de búsqueda.
Mintlify gestiona automáticamente muchas prácticas recomendadas de SEO, entre ellas:
* Generación de metaetiquetas
* Generación de `sitemap` y del archivo `robots.txt`
* Estructura HTML semántica
* Optimización móvil
Puedes personalizar por completo las metaetiquetas de tu sitio añadiendo el campo `metatags` a tu `docs.json` o al frontmatter de una página.
## Meta tags generados automáticamente
Mintlify genera las siguientes meta tags para cada página. Puedes sobrescribir estas meta tags especificándolas en tu `docs.json` o en el frontmatter de una página.
**Metadatos básicos:**
* `charset: utf-8` - Codificación de caracteres
* `og:type: website` - Tipo de Open Graph
* `og:site_name` - Nombre de tu sitio de documentación
* `twitter:card: summary_large_image` - Tipo de tarjeta de Twitter
**Metadatos específicos de la página:**
* `title` - Título de la página, con el formato "Título de la página - Nombre del sitio"
* `og:title` - Título de Open Graph, por defecto usa el título de la página
* `twitter:title` - Título de Twitter, recurre a `og:title` y luego al título de la página
* `description` - Descripción de la página
* `og:description` - Descripción de Open Graph, recurre a la descripción de la página
* `twitter:description` - Descripción de Twitter, recurre a `og:description` y luego a la descripción de la página
**URL y canonical:**
* `canonical` - Se genera automáticamente a partir de la URL de la página
* `og:url` - Se establece en la URL canónica
**SEO e indexación:**
* `robots` - Generado a partir de los metadatos de la página
* `noindex` - Generado a partir de los metadatos de la página
* `keywords` - Generado a partir de los metadatos de la página
**Imágenes:**
* `og:image` - Imagen de Open Graph, `og:image:width` establecido en 1200 y `og:image:height` en 630
* `twitter:image` - Imagen de Twitter, `twitter:image:width` establecido en 1200 y `twitter:image:height` en 630
**Metadatos del navegador y la aplicación:**
* `applicationName` - Nombre de tu sitio de documentación
* `generator: Mintlify` - Identifica a Mintlify como el generador del sitio
* `apple-mobile-web-app-title` - Nombre de la aplicación en la pantalla de inicio de iOS
* `msapplication-TileColor` - Color del mosaico de Windows
* Favicons e iconos de tu configuración
* Enlace de referencia al mapa del sitio (sitemap)
Cualquier meta tag en tu configuración `docs.json` `seo.metatags` también se inyecta automáticamente en cada página, como `google-site-verification` para la validación en Google Search Console.
## Imágenes OG
Mintlify genera automáticamente una imagen Open Graph (OG) para cada página. Esta imagen aparece como vista previa social cuando compartes un enlace en plataformas de redes sociales y aplicaciones de mensajería.
Propiedades predeterminadas de la imagen OG:
* Ancho: 1200px
* Alto: 630px
* El logo de tu sitio del campo `logo` en `docs.json`
* El título de la página del frontmatter `title` de la página
* La descripción de la página del frontmatter `description` de la página
* El color primario de tu sitio del campo `colors` en `docs.json`
### Imágenes OG personalizadas
Hay tres formas de personalizar las imágenes OG, según el nivel de control que necesites.
**Imagen de fondo personalizada**
Para usar una imagen de fondo personalizada manteniendo la superposición autogenerada de logo, título y descripción, configura `thumbnails.background` en tu `docs.json`.
```json Example docs.json theme={null}
"thumbnails": {
"background": "/images/og-background.png"
}
```
Consulta [`thumbnails`](/es/organize/settings-appearance#thumbnails) para ver la lista completa de opciones de personalización.
**Imagen OG estática para todas las páginas**
Para reemplazar completamente la imagen autogenerada con una única imagen estática en todas las páginas, configura `og:image` en tus metaetiquetas globales.
```json Example docs.json theme={null}
"seo": {
"metatags": {
"og:image": "https://example.com/og-image.png"
}
}
```
**Imagen OG estática para una página específica**
Para sobrescribir la imagen OG de una sola página, configura `og:image` en el frontmatter de esa página.
```yaml Example frontmatter theme={null}
---
title: "Your page title"
description: "Your page description"
"og:image": "https://example.com/custom-og.png"
---
```
Configurar `og:image` en las metaetiquetas, ya sea globalmente o por página, reemplaza la vista previa social autogenerada con una imagen estática. Si quieres que Mintlify superponga automáticamente tu logo, el título de la página y la descripción sobre un fondo personalizado, usa [`thumbnails.background`](/es/organize/settings-appearance#param-thumbnails-background) en su lugar.
## Metadatos globales
Para establecer metadatos predeterminados para todas las páginas, agrega el campo `metatags` a tu `docs.json`.
```json theme={null}
"seo": {
"metatags": {
"og:image": "enlace a tu imagen de meta etiqueta por defecto"
}
}
```
### Configura una URL canónica
Una URL canónica indica a los motores de búsqueda qué versión de tu documentación es la principal. Esto mejora el SEO cuando tu documentación es accesible desde varias URL y evita problemas de contenido duplicado.
**Canónica global**
Si utilizas un dominio personalizado, configura la metaetiqueta `canonical` en tu `docs.json` para asegurarte de que los motores de búsqueda indexen tu dominio preferido. Mintlify añade la ruta de cada página a esta URL base.
```json theme={null}
"seo": {
"metatags": {
"canonical": "https://www.your-custom-domain-here.com"
}
}
```
**Canónica por página**
Para establecer una URL canónica para una página específica, añade `canonical` al frontmatter de esa página. Esto anula la canónica global y cualquier canónica autogenerada para esa página. Es útil para documentación versionada en la que quieres que las páginas de versiones anteriores apunten a su equivalente en la versión más reciente.
```yaml theme={null}
---
title: "My Page"
canonical: "https://docs.example.com/latest/my-page"
---
```
Verifica siempre el comportamiento de la URL canónica en tu sitio desplegado. Las compilaciones locales añaden `/src/_props` a las URL como un artefacto que no forma parte de la URL canónica.
## Metaetiquetas específicas de página
Para configurar metaetiquetas específicas de página, agrégalas al frontmatter de la página.
Las metaetiquetas específicas de página incluyen:
* `title` - Título de la página
* `description` - La descripción de la página aparece debajo del título en la página y en algunos resultados de motores de búsqueda
* `canonical` - URL canónica de esta página; anula la canónica autogenerada
* `keywords` - Palabras clave separadas por comas
* `og:title` - Título de Open Graph para compartir en redes sociales
* `og:description` - Descripción de Open Graph, recurre a `description`
* `og:image` - URL de la imagen de Open Graph
* `og:url` - URL de Open Graph
* `og:type` - Tipo de Open Graph como "article" o "website"
* `og:image:width` - Ancho de la imagen de Open Graph
* `og:image:height` - Altura de la imagen de Open Graph
* `twitter:title` - Título de la tarjeta de Twitter, recurre a `og:title` y luego a `title`
* `twitter:description` - Descripción de la tarjeta de Twitter, recurre a `og:description` y luego a `description`
* `twitter:image` - Imagen de la tarjeta de Twitter
* `twitter:card` - Tipo de tarjeta de Twitter como `summary` o `summary_large_image`
* `twitter:site` - Cuenta del sitio en Twitter
* `twitter:image:width` - Ancho de la imagen de Twitter
* `twitter:image:height` - Altura de la imagen de Twitter
* `noindex` - Establécelo en `true` para evitar que los motores de búsqueda indexen la página
* `robots` - Valor de la metaetiqueta robots
Las metaetiquetas de Twitter heredan automáticamente de sus equivalentes de Open Graph. Por ejemplo, si configuras `og:title` pero no `twitter:title`, la tarjeta de Twitter usa el valor de `og:title`. Configura `twitter:title` o `twitter:description` explícitamente solo cuando quieras un texto diferente en Twitter que en otras plataformas.
```mdx theme={null}
---
title: "Título de tu página de ejemplo"
description: "Descripción específica de la página"
"og:title": "Título para redes sociales"
"og:description": "Descripción personalizada para compartir en redes sociales"
"og:image": "enlace a tu imagen de meta tag"
"twitter:title": "Título específico para Twitter"
keywords: ["keyword1", "keyword2"]
---
```
Las metaetiquetas con dos puntos deben ir entre comillas. Por ejemplo, `og:title: "Social media title"`.
El campo `keywords` debe estar en formato de lista YAML. Por ejemplo, `keywords: ["keyword1", "keyword2", "keyword3"]`.
## Referencia de etiquetas meta comunes
A continuación encontrarás una lista completa de etiquetas meta que puedes añadir a tu `docs.json`. Estas etiquetas ayudan a mejorar el SEO de tu sitio, el rendimiento en redes sociales y la compatibilidad con navegadores.
Configurar `og:image` en las metaetiquetas reemplaza la vista previa social generada automáticamente con una imagen estática. Si deseas una **imagen de fondo** personalizada sobre la que Mintlify superponga automáticamente tu logotipo, el título de la página y la descripción, usa [`thumbnails.background`](/es/organize/settings-reference#thumbnails-background) en tu `docs.json`.
Puedes previsualizar cómo se muestran tus etiquetas meta en diferentes plataformas usando [metatags.io](https://metatags.io/).
```json expandable theme={null}
"seo": {
"metatags": {
"robots": "noindex",
"charset": "UTF-8",
"viewport": "width=device-width, initial-scale=1.0",
"description": "Descripción de la página",
"keywords": "palabra_clave1, palabra_clave2, palabra_clave3",
"author": "Nombre del Autor",
"robots": "index, follow",
"googlebot": "index, follow",
"google": "notranslate",
"google-site-verification": "verification_token",
"generator": "Mintlify",
"theme-color": "#000000",
"color-scheme": "light dark",
"canonical": "https://your-custom-domain-here.com",
"format-detection": "telephone=no",
"referrer": "origin",
"refresh": "30",
"rating": "general",
"revisit-after": "7 days",
"language": "en",
"copyright": "Copyright 2024",
"reply-to": "email@example.com",
"distribution": "global",
"coverage": "Mundial",
"category": "Tecnología",
"target": "all",
"HandheldFriendly": "True",
"MobileOptimized": "320",
"apple-mobile-web-app-capable": "yes",
"apple-mobile-web-app-status-bar-style": "black",
"apple-mobile-web-app-title": "Título de la App",
"application-name": "Nombre de la App",
"msapplication-TileColor": "#000000",
"msapplication-TileImage": "path/to/tile.png",
"msapplication-config": "path/to/browserconfig.xml",
"og:title": "Título de Open Graph",
"og:type": "website",
"og:url": "https://example.com",
"og:image": "https://example.com/image.jpg",
"og:description": "Descripción de Open Graph",
"og:site_name": "Nombre del Sitio",
"og:locale": "en_US",
"og:video": "https://example.com/video.mp4",
"og:audio": "https://example.com/audio.mp3",
"twitter:card": "summary",
"twitter:site": "@username",
"twitter:creator": "@username",
"twitter:title": "Título de Twitter",
"twitter:description": "Descripción de Twitter",
"twitter:image": "https://example.com/image.jpg",
"twitter:image:alt": "Descripción de la Imagen",
"twitter:player": "https://example.com/player",
"twitter:player:width": "480",
"twitter:player:height": "480",
"twitter:app:name:iphone": "Nombre de la App",
"twitter:app:id:iphone": "12345",
"twitter:app:url:iphone": "app://",
"article:published_time": "2024-01-01T00:00:00+00:00",
"article:modified_time": "2024-01-02T00:00:00+00:00",
"article:expiration_time": "2024-12-31T00:00:00+00:00",
"article:author": "Nombre del Autor",
"article:section": "Tecnología",
"article:tag": "etiqueta1, etiqueta2, etiqueta3",
"book:author": "Nombre del Autor",
"book:isbn": "1234567890",
"book:release_date": "2024-01-01",
"book:tag": "etiqueta1, etiqueta2, etiqueta3",
"profile:first_name": "John",
"profile:last_name": "Doe",
"profile:username": "johndoe",
"profile:gender": "male",
"music:duration": "205",
"music:album": "Nombre del Álbum",
"music:album:disc": "1",
"music:album:track": "1",
"music:musician": "Nombre del Artista",
"music:song": "Nombre de la Canción",
"music:song:disc": "1",
"music:song:track": "1",
"video:actor": "Nombre del Actor",
"video:actor:role": "Nombre del Papel",
"video:director": "Nombre del Director",
"video:writer": "Nombre del Guionista",
"video:duration": "120",
"video:release_date": "2024-01-01",
"video:tag": "etiqueta1, etiqueta2, etiqueta3",
"video:series": "Nombre de la Serie"
}
}
```
## Sitemaps y archivos robots.txt
Mintlify genera automáticamente un archivo `sitemap.xml` y un archivo `robots.txt`. Puedes ver tu sitemap añadiendo `/sitemap.xml` a la URL de tu sitio de documentación.
Por defecto, Mintlify solo indexa las páginas que incluyes en la navegación de tu `docs.json`. Excluye las [páginas ocultas](/es/organize/hidden-pages) que existen en tu repositorio pero no están listadas en tu navegación de:
* Sitemaps para motores de búsqueda
* Búsqueda interna de documentación
* Contexto del [asistente de IA](/es/assistant/index)
* Resultados de búsqueda del [servidor MCP](/es/ai/model-context-protocol)
Para incluir páginas ocultas en la indexación de búsqueda, añade `seo.indexing` a tu `docs.json`:
```json theme={null}
"seo": {
"indexing": "all"
}
```
Para incluir solo las páginas que están bajo una pestaña o un grupo oculto específico, establece `searchable: true` en esa pestaña o grupo. Consulta [Búsqueda, SEO e indexación de IA](/es/organize/hidden-pages#search-seo-and-ai-indexing) para más detalles.
Para sitios de documentación que requieren autenticación, los sitemaps y los archivos `robots.txt` también requieren autenticarse para acceder a ellos. Los sitemaps excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups).
### Directivas Content-Signal
El `robots.txt` generado automáticamente incluye directivas [Content-Signal](https://contentsignals.org) que indican a los rastreadores de IA cómo pueden usar tu documentación. Estas señales siguen la política Content Signals de Cloudflare y se aplican a todos los agentes de usuario:
```txt theme={null}
User-agent: *
Content-Signal: ai-train=yes, search=yes, ai-input=yes
```
Las señales predeterminadas habilitan tu documentación para:
* `ai-train=yes`—Entrenamiento de modelos de IA.
* `search=yes`—Creación de índices de búsqueda.
* `ai-input=yes`—Generación de respuestas con IA, incluyendo generación aumentada por recuperación y asistentes de IA.
Estos valores por defecto ayudan a que herramientas de IA como ChatGPT, Claude y Perplexity descubran y citen tu documentación. Para cambiar las señales, [añade un `robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto. Mintlify sirve los archivos personalizados tal cual, sin las directivas Content-Signal predeterminadas.
### Sitemaps y archivos robots.txt personalizados
Para añadir un archivo `sitemap.xml` o `robots.txt` personalizado, crea un archivo `sitemap.xml` o `robots.txt` en la raíz de tu proyecto. Añadir un archivo personalizado sustituye al archivo generado automáticamente con el mismo nombre. Si eliminas un archivo personalizado, el archivo predeterminado se aplicará de nuevo automáticamente.
Si tu archivo `robots.txt` personalizado bloquea agentes de usuario de IA como `GPTBot`, `ClaudeBot` o `PerplexityBot`, las herramientas de IA no pueden rastrear tu documentación ni citarla en sus respuestas. Consulta [Permitir agentes de IA en robots.txt](/es/guides/geo#allow-ai-agents-in-robotstxt) para más detalles.
## Desactivar la indexación
Para evitar que los motores de búsqueda indexen una página, agrega `noindex: true` al [frontmatter](/es/organize/pages) de la página.
```yaml theme={null}
---
noindex: true
---
```
Las páginas con `hidden: true` en su frontmatter se consideran automáticamente como `noindex: true`. Consulta [Páginas ocultas](/es/organize/hidden-pages) para más detalles.
También puedes especificar `noindex` para todas las páginas de tu documentación estableciendo el campo `metatags.robots` en `"noindex"` en tu `docs.json`:
```json theme={null}
"seo": {
"metatags": {
"robots": "noindex"
}
}
```
### Desactivar la indexación de todo el proyecto
Para ocultar todo tu despliegue de los motores de búsqueda manteniéndolo públicamente accesible, activa **Don't index project** en tu panel, en **Settings > Deployment > Add-ons > Visibility**.
Cuando se activa, Mintlify:
* Renderiza todas las páginas con las metaetiquetas robots `noindex, nofollow`.
* Devuelve un `sitemap.xml` vacío.
* Devuelve `404` para `llms.txt` y `llms-full.txt`.
* Borra tu índice de búsqueda para que las páginas dejen de aparecer en la búsqueda interna, el [Asistente de IA](/es/assistant/index) o el [servidor MCP](/es/ai/model-context-protocol).
* Sirve un `robots.txt` que bloquea todo el sitio:
```txt theme={null}
User-agent: *
Content-Signal: ai-train=no, search=no, ai-input=no
Disallow: /
```
Usa esta opción cuando quieras mantener un despliegue en línea para revisión interna, pruebas o uso compartido limitado, pero no quieras que aparezca en los resultados públicos de búsqueda ni que se utilice como datos de entrenamiento o de recuperación para herramientas de IA.
Cambiar este ajuste desencadena un redespliegue de tu sitio. Los cambios surten efecto una vez completado el redespliegue.
Esta opción funciona junto con otros controles de indexación:
* **`noindex` por página**—Los ajustes `noindex: true` en el frontmatter de una página siguen aplicándose cuando la opción a nivel de proyecto está desactivada. La opción a nivel de proyecto anula los ajustes por página cuando está activada, por lo que todas las páginas se tratan como `noindex`.
* **`robots.txt` personalizado**—Si tienes un [`robots.txt` personalizado](#custom-sitemaps-and-robotstxt-files) en la raíz de tu proyecto, Mintlify lo sirve sin modificaciones. La opción a nivel de proyecto no reemplaza un `robots.txt` personalizado, así que actualiza o elimina tu archivo personalizado por separado si necesitas que las reglas para rastreadores coincidan.
## Mejores prácticas de SEO
* Usa títulos de página claros y descriptivos (50-60 caracteres)
* Redacta descripciones convincentes (150-160 caracteres)
* Incluye palabras clave relevantes
* Haz que cada título de página y cada descripción sean únicos
* Utiliza una jerarquía de encabezados adecuada (H1 → H2 → H3)
* Escribe para personas primero y para motores de búsqueda después
* Incluye palabras clave relevantes en los encabezados y el contenido
* Mantén las URL cortas, descriptivas y organizadas jerárquicamente
* Divide el contenido extenso con subtítulos y listas
* Enlaza a páginas relacionadas dentro de tu documentación
* Usa texto de anclaje descriptivo en lugar de "haz clic aquí"
* Crea clústeres de temas enlazando conceptos relacionados
* Utiliza las funciones automáticas de referencias cruzadas
* Usa nombres de archivo descriptivos para las imágenes
* Incluye siempre texto alternativo por accesibilidad y SEO
* Optimiza el tamaño de los archivos de imagen para una carga más rápida
* Usa imágenes relevantes que respalden tu contenido