01Qué es y cómo funciona
El manifest se encuentra en /manifest.json (o en otra ruta que declares) y se enlaza desde el HTML ` con . Los campos clave incluyen name (nombre completo de la marca), short_name (etiqueta bajo el icono), icons (matriz de objetos de imagen con src, sizes, type, purpose), theme_color (color de la interfaz del navegador), background_color (color de la pantalla de inicio), display (standalone, minimal-ui o browser), start_url (punto de entrada) y scope` (límite de navegación). Los rastreadores de IA que renderizan páginas —como los que impulsan los AI Overviews o las citas de chat— obtienen el manifest para extraer los activos de marca autorizados en lugar de adivinarlos a partir de las etiquetas meta de HTML.
Es un pequeño archivo de texto que otorga a tu sitio un nombre, logotipo y esquema de colores consistentes donde sea que una IA o un navegador lo muestre.
02Qué hacer al respecto
Crea un manifest.json válido en la raíz o en una ruta conocida. Incluye al menos un icono PNG de 512×512 con purpose: "any maskable" para que funcione como icono adaptable en Android y como alternativa en otros lugares. Establece el theme_color con el valor hexadecimal de tu color de marca principal y el background_color con un color sólido a juego para la pantalla de inicio (splash screen). Elige display: "standalone" para una sensación de aplicación. Vincula el manifest en el `` de cada página canónica. Realiza pruebas con la auditoría PWA de Lighthouse y el panel Application de Chrome DevTools para confirmar que el manifest se analiza correctamente y los iconos se cargan. Vuelve a validarlo tras cualquier rediseño o cambio de logotipo.
03Cómo se mide o se detecta
Abre Chrome DevTools → Application → Manifest para ver los campos analizados y las vistas previas de los iconos. Ejecuta Lighthouse (Performance → Progressive Web App) y comprueba las auditorías de "Manifest" e "Icons". En Search Console, el informe de Mejoras → Resultados enriquecidos puede mostrar datos estructurados relacionados con el manifest si también utilizas el esquema WebApplication. Para la búsqueda con IA, monitoriza cómo aparece tu marca en los AI Overviews, las citas de Perplexity o los resultados de navegación de ChatGPT; un nombre, logotipo y color consistentes indican que el manifest se está leyendo correctamente. La ausencia de un logotipo o el uso de un favicon genérico en esas superficies suele significar que el manifest falta, está mal formado o está bloqueado.
04Errores comunes
- Servir el manifest con
Content-Type: text/plainen lugar deapplication/manifest+jsonoapplication/json. - Proporcionar solo un icono de 192×192; las pantallas grandes luego reducen la escala de una imagen borrosa.
- Omitir
purpose: "maskable"para que el icono aparezca con un fondo blanco en Android. - Configurar
start_urlcomo/con un error de barra final (trailing slash) que crea un error de alcance (scope error). - Bloquear
/manifest.jsonenrobots.txto mediante encabezadosnoindex. - Duplicar el enlace del manifest con diferentes valores de
hrefen la misma página.
05Límites
El manifest no influye directamente en el ranking. Solo afecta la presentación cuando la página se instala o cuando un sistema de IA decide mostrar los activos de la marca. No es un sustituto de la marcada de schema.org WebApplication u Organization; estas proporcionan datos estructurados para paneles de conocimiento y resultados enriquecidos, mientras que el manifest controla la interfaz de usuario de instalación de la PWA. Si su sitio no es instalable (sin service worker, sin HTTPS), los navegadores ignorarán el manifest. Los rastreadores de IA que no renderizan JavaScript no recuperarán un manifest inyectado en el lado del cliente; el archivo debe estar presente en la respuesta HTML inicial.
06Ejemplo práctico
Un manifest mínimo y listo para producción para una marca llamada "Acme Analytics":
{
"name": "Acme Analytics",
"short_name": "Acme",
"start_url": "/",
"display": "standalone",
"background_color": "#003366",
"theme_color": "#003366",
"icons": [
{
"src": "/icons/icon-192.png",
"sizes": "192x192",
"type": "image/png",
"purpose": "any"
},
{
"src": "/icons/icon-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any maskable"
}
]
}
07Preguntas frecuentes
¿En qué se diferencia un web-manifest de las meta tags como apple-touch-icon o theme-color?
Un web-manifest consolida todas las señales de instalación y branding en un único archivo JSON, mientras que las meta tags las dispersan por todo el <head> del HTML. El manifest es la fuente única de verdad para las PWA y los rastreadores de IA; las meta tags siguen siendo soluciones de respaldo para navegadores antiguos y algunas plataformas sociales.
¿Necesito un web-manifest si mi sitio no es una progressive web app?
Sí, si quieres tener control sobre cómo aparece tu marca cuando la búsqueda de IA muestra tu contenido o cuando los usuarios añaden la página a su pantalla de inicio. Sin él, los navegadores y los sistemas de IA recurren a iconos genéricos, títulos truncados y colores de tema predeterminados.
¿Quién debe crear y mantener el manifest: desarrolladores, diseñadores o SEO?
Los desarrolladores suelen ser los encargados de crear el archivo porque debe ser un JSON válido y servirse con el tipo MIME correcto. Los diseñadores proporcionan los activos de iconos y los valores de color. Los responsables de SEO o de producto definen los campos name, short_name y description que las respuestas de la IA podrían citar.
¿Sigue siendo importante el manifest ahora que los crawlers de IA pueden leer HTML directamente?
Sí. Los crawlers de IA utilizan el manifest como un resumen estructurado y legible por máquinas de la identidad de marca. Esto reduce la ambigüedad en comparación con el análisis de meta tags dispersos y garantiza una representación coherente en interfaces de chat, asistentes de voz y fragmentos de búsqueda.
¿Qué ocurre si mi manifest tiene un JSON no válido o le faltan campos obligatorios?
Los navegadores y los crawlers de IA ignorarán el archivo por completo y recurrirán a la extracción heurística del HTML. No verás ningún aviso de instalación, aparecerán iconos genéricos y es posible que el título de la página se vea truncado en las respuestas de la IA. El error es silencioso: no habrá advertencias en la consola a menos que revises las DevTools.
¿Cuánto tiempo después de implementar un manifest lo detectarán las funciones de búsqueda de IA?
No existe un SLA fijo. La mayoría de los crawlers de IA vuelven a rastrear durante su ciclo normal de recrawl, que puede oscilar entre horas y semanas. Puedes acelerar el descubrimiento enviando la URL del manifest a través de IndexNow o de la herramienta de inspección de URLs de la search console, pero el manifest por sí mismo no activa un rastreo prioritario.
08Preguntado en voz alta
El mismo término en las palabras que alguien usa al hablar con un asistente en lugar de escribir en un buscador: escrito desde la situación, y por eso cada pregunta lleva la situación de la que salió.
Un web-manifest —un archivo JSON enlazado en el <head> del HTML— define el nombre de instalación, los iconos, el color del tema y el modo de visualización. Corrige el manifest.json y la próxima instalación utilizará los recursos corregidos.
Edita el campo theme_color en tu web-manifest. Las funciones de búsqueda de IA leen ese valor directamente, por lo que el cambio aparecerá tan pronto como se vuelva a rastrear el manifest.
Busca una etiqueta <link rel="manifest" href="/manifest.json"> en el código fuente de la página. Ese archivo manifest contiene todos los recursos de branding que utilizan el aviso de instalación y las respuestas de IA.