PWA Origin Migration en Chrome 150: cómo cambiar de dominio sin perder instalaciones

Chrome prepara una mejora bastante más importante de lo que parece para quien mantiene una Progressive Web App seria. Con PWA Origin Migration, anunciado oficialmente el 3 de junio de 2026, Google quiere resolver un problema muy viejo: mover una PWA a otro dominio o subdominio del mismo sitio sin obligar al usuario a desinstalarla y volver a instalarla a mano.

La novedad llega explicada por Chrome for Developers dentro del camino hacia Chrome 150, y encaja muy bien con otras piezas recientes del ecosistema web que ya hemos comentado en Aketdoy, como Modern Web Guidance, Prompt API de Chrome 148 o WebMCP en Chrome. Aquí el foco no está en la IA, sino en algo mucho más terrenal: no romper la identidad de tu app web cuando cambias arquitectura.

Qué es PWA Origin Migration

Hasta ahora, si una PWA instalada pasaba por ejemplo de www.ejemplo.com/app a app.ejemplo.com, la transición era torpe. La identidad de la app estaba ligada al origin anterior, así que el usuario podía quedarse con una instalación vieja, otra nueva separada o, directamente, una experiencia rota.

Según el anuncio oficial Change domains without losing users, Chrome 150 introduce un mecanismo para migrar PWAs instaladas entre orígenes del mismo sitio mediante un apretón de manos entre el origen viejo y el nuevo. Traducido: si controlas ambos lados y declaras la migración correctamente, Chrome puede presentar el cambio como una actualización de app en vez de como una ruptura.

La propuesta también sirve para corregir otro error bastante común: las instalaciones duplicadas que aparecen cuando un desarrollador cambia el start_url sin haber fijado antes un id estable en el manifest. El propio explainer oficial de WICG lo llama problema de split apps.

Desarrollador revisando una migración de PWA en un puesto de trabajo realista con navegador y panel técnico
La gracia de esta función no es estética: evita que una PWA cambie de casa rompiendo la instalación del usuario.

Por qué importa de verdad

La noticia parece pequeña si solo lees el titular, pero para producto y desarrollo web tiene bastante peso.

1. Permite reorganizar arquitectura sin castigar a quien ya instaló la app

Hay cambios perfectamente razonables que antes eran un dolor: separar una app de la web principal, pasar de una ruta interna a un subdominio dedicado, hacer rebranding o limpiar una estructura heredada. Si el usuario tenía que reinstalar manualmente, el coste real era más alto de lo que parece.

2. Reduce el riesgo de instalaciones partidas o desactualizadas

El explainer de WICG sobre migración de PWAs deja claro que este mecanismo también busca corregir apps duplicadas o viejas que quedan colgadas cuando la identidad de la PWA cambia por accidente. Eso, en equipos reales, es más habitual de lo que debería.

3. Hace más predecible la evolución de proyectos web grandes

En muchos productos modernos la app no vive ya en una sola URL limpia. Hay subdominios, herramientas asociadas y experiencias repartidas. Google lleva tiempo tocando este problema también con Web App Scope Extensions, que ayuda a que una PWA multi-origen se comporte de forma más unificada. PWA Origin Migration no hace exactamente lo mismo, pero va en esa misma dirección: dar más libertad técnica sin romper la experiencia.

Cómo funciona en Chrome 150

La base es una validación en dos direcciones entre la app nueva y el origen anterior. Chrome pide pruebas de que ambos lados están controlados por la misma entidad.

Los pasos importantes que cita la documentación oficial son estos:

  • la app nueva declara en su manifest un campo migrate_from apuntando al origen o identidad anterior;
  • el origen antiguo publica un archivo /.well-known/web-app-origin-association autorizando la migración con allow_migration;
  • si quieres empujar la transición antes, la app vieja puede añadir un migrate_to para señalizar el destino;
  • el manifest de destino debe incluir un id explícito, algo clave para no volver a caer en instalaciones partidas.

Además, Google permite elegir el tono de la migración con el campo behavior:

  • suggest: Chrome propone el cambio sin bloquear al usuario;
  • force: la siguiente vez que abra la app vieja, el usuario deberá migrar o desinstalarla.

Lo interesante aquí es que Chrome intenta que el proceso se parezca a una actualización de app web normal. Es mucho más razonable que dejar un icono viejo muerto o abrir de repente la nueva URL en una pestaña del navegador sin contexto.

Qué no resuelve

Aquí conviene bajar un poco la euforia, porque la mejora es útil, pero no mágica.

No vale para cualquier cambio de dominio

La primera versión está limitada a migraciones same-site. No es una vía general para mover una PWA desde un sitio a otro distinto sin fricción. Google lo restringe así por seguridad: abrir la puerta a migraciones entre sitios diferentes sería mucho más peligroso.

No migra automáticamente todos los datos locales

El explainer de WICG deja claro que los datos guardados localmente, como IndexedDB o Cache Storage, quedan fuera del alcance de esta función. Si tu PWA depende de almacenamiento local importante, tendrás que planificar esa parte con lógica propia.

Los permisos no se heredan como por arte de magia

En la versión inicial, los permisos concedidos o denegados no se trasladan automáticamente al nuevo origen. Eso significa que notificaciones, ubicación u otros accesos sensibles pueden necesitar una nueva concesión por parte del usuario.

Detalle realista de un puesto de desarrollo con teclado, monitor y flujo técnico de migración de PWA
La migración de origen arregla la identidad de la app, pero no te evita planificar datos, permisos y despliegue con cuidado.

Cuándo tiene sentido usarlo

Mi lectura es bastante clara: esto tiene valor sobre todo para equipos que ya tienen una PWA instalada por usuarios reales y necesitan moverla con una razón seria detrás. Por ejemplo:

  • pasar de una ruta interna a un subdominio dedicado;
  • separar una app del sitio corporativo principal;
  • corregir una identidad rota por un manifest mal definido;
  • hacer rebranding sin dejar instalaciones antiguas en tierra de nadie.

Si estás todavía en una fase muy inicial, seguramente lo más sensato es diseñar bien el manifest desde el principio y fijar el id estable cuanto antes. En ese sentido, esta novedad también funciona como recordatorio de algo básico: la arquitectura de una PWA no debería improvisarse. Igual que al montar una web conviene dejar bien pensados dominio, estructura y publicación desde el inicio, como contamos en nuestra guía para crear una página web en WordPress desde cero, aquí el coste de decidir tarde también existe.

Preguntas frecuentes sobre PWA Origin Migration

¿PWA Origin Migration ya está disponible para todo el mundo?

No exactamente. Google lo ha presentado como función que llega con Chrome 150, así que conviene revisar el canal y el ritmo de despliegue real antes de depender de ello en producción.

¿Sirve para mover una PWA a un dominio totalmente distinto?

No. La propuesta inicial se centra en migraciones dentro del mismo sitio, precisamente para reducir riesgos de seguridad.

¿Evita tener que reinstalar manualmente la app?

Esa es justo la idea principal. Si la migración está bien declarada y validada, Chrome puede presentarla como una actualización guiada en lugar de exigir un proceso manual al usuario.

¿También resuelve los datos locales o los permisos?

No del todo. La identidad y la transición de instalación mejoran, pero los datos locales y los permisos siguen requiriendo planificación aparte.

Fuentes oficiales

Conclusión

PWA Origin Migration no es el anuncio más vistoso de Chrome, pero puede ahorrarle bastantes dolores de cabeza a quien mantiene una app web instalada por usuarios de verdad. Si se confirma un despliegue estable y el flujo se comporta como promete Google, cambiar una PWA de dominio dejará de ser esa operación incómoda que mezcla riesgo técnico, confusión de usuario y pérdida potencial de instalaciones.

Para mí, lo más valioso no es solo la función en sí, sino el mensaje de fondo: Chrome está tratando las PWAs cada vez más como software serio, con identidad, actualizaciones y transiciones más previsibles. Y eso, para la web, es una buena noticia.

Deja un comentario

Demuestra que eres humano ;) * Time limit is exhausted. Please reload CAPTCHA.

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.