Progressive Web Apps (PWAs) are increasingly treated like first-class applications by users and browsers alike. That makes changing a PWA’s domain (origin) a high‑risk move if it’s not handled correctly. With changes available from Chrome 150 onward, it’s now possible to migrate a PWA to a new same‑site origin with minimal disruption and without forcing users through a painful reinstall.
This guide explains how origin migration works for PWAs, what “same‑site” means in practice, and how business owners and developers can plan and execute a smooth transition when rebranding, restructuring infrastructure, or consolidating domains.
Key Takeaways
- Chrome 150 introduces support for seamless PWA origin migration when moving between same-site origins.
- Users keep their installed PWA (icon, settings, and data) while you switch to a new domain, reducing friction and churn.
- Strict same-site requirements mean the old and new domains must share the same registrable domain to qualify.
- Careful planning of service workers, manifests, and redirects is essential to avoid broken experiences or data loss.
Why PWA Origin Migration Matters for Modern Businesses
For many organizations, a PWA is more than a website—it’s a core customer touchpoint comparable to a native mobile app. Installed PWAs live on users’ devices with their own icon, offline capabilities, and stored data. When you change domains, that installed experience typically does not follow automatically, creating serious risks:
- Loss of returning traffic and engagement
- Broken shortcuts and app icons on user home screens
- Confusion during rebrands or domain consolidations
- Additional support burden as users struggle to “find” your app again
Until now, changing a PWA’s origin meant effectively asking every user to reinstall the app under the new domain. For businesses operating at scale, that’s a significant barrier and can translate into measurable revenue loss.
Typical Scenarios Where You Need Origin Migration
Common business and technical scenarios that require a PWA origin change include:
- Rebranding: Moving from
myapp-old.comtomyapp.comafter an acquisition or branding update. - Infrastructure changes: Consolidating multiple subdomains (e.g.,
app.example.comtopwa.example.com). - Hosting and architecture upgrades: Migrating to a new hosting provider, CDN, or multi-region architecture that uses a new origin.
- Security and compliance: Shifting from legacy or shared domains to hardened, dedicated origins.
With Chrome 150 and later, you can migrate a PWA between same-site origins while preserving the installed app, reducing friction for users and protecting your active install base.
Understanding Same-Site Origins and PWA Behavior
Origin migration support is powerful but intentionally constrained for security and privacy reasons. To use it correctly, you need a clear understanding of how browsers define “same-site” and how that affects your migration strategy.
What Does “Same-Site” Mean?
In browser terms, the “site” is defined by the scheme (protocol), registrable domain, and port. Two origins are considered same-site if they share the same registrable domain and scheme, even if the subdomains differ. For example:
https://app.example.comandhttps://pwa.example.comare same-site.https://example.comandhttps://www.example.comare same-site.https://myapp.comandhttps://myapp.netare not same-site.http://example.comandhttps://example.comare different due to the scheme.
Chrome’s PWA origin migration feature currently applies only to moves where the old and new origins are same-site. Cross-site migrations (for example, from myapp-old.com to myapp.com) still require a more traditional migration strategy with careful redirects and user communication.
How PWAs Are Tied to an Origin
Every PWA is tightly coupled to the origin where it’s installed:
- The service worker is scoped to a specific origin and path.
- The web app manifest (
manifest.json) is fetched and validated relative to that origin. - Persistent storage (IndexedDB, Cache Storage, localStorage) is partitioned by origin.
Historically, this meant that moving to a new origin effectively created a “new app” from the browser’s perspective. Chrome 150 introduces mechanisms to treat certain origin changes as migrations instead of replacements, within strict security boundaries.
How Seamless PWA Origin Migration Works in Chrome 150+
At a high level, seamless migration allows Chrome to:
- Recognize that a PWA installed from one origin is now available at another same-site origin.
- Update the installed app to use the new origin instead of uninstalling and reinstalling.
- Preserve user-facing aspects such as the app icon, name, and presence in app launchers.
This process minimizes disruptions for users and helps maintain continuity during technical or branding changes.
Key Requirements for Migration
To take advantage of seamless origin migration, your setup should satisfy several conditions:
- Same-site origins: Both old and new origins must share the same registrable domain and scheme (for example, from
https://app.example.comtohttps://pwa.example.com). - Equivalent PWA identity: The web app manifest should represent the same app identity (same or consistent
name,short_name, andidvalues). - Valid HTTPS configuration: Both origins must serve content over HTTPS with correctly configured certificates.
- Thoughtful redirect strategy: Requests to the old origin should be redirected to the new origin without breaking service worker updates.
Chrome uses a combination of manifest data, user interaction history, and network behavior to determine whether it should treat the new origin as a continuation of the existing app.
Data and Service Worker Considerations
Even when the migration is seamless from the user’s perspective, developers must carefully manage:
- Service worker scripts: Ensure the service worker at the new origin is compatible with the previous version so cached assets and queued requests are handled correctly.
- Stored data: Plan for data migration if you use origin-specific keys or back-end APIs tied to the old domain.
- Offline behavior: Test the PWA’s offline functionality post-migration to ensure it still works as expected.
In many same-site migrations, user data stored in IndexedDB or Cache Storage will not automatically “move” between origins. You may need to implement client- or server-side strategies to reconcile or re-fetch necessary data under the new origin.
Practical Migration Strategy for Business and Development Teams
A successful PWA origin migration is a coordinated effort involving product owners, developers, DevOps, and sometimes marketing or legal teams. Below is a practical blueprint you can adapt.
1. Plan the Migration
Before touching production, map out the full scope:
- Confirm that the old and new origins qualify as same-site.
- Audit all PWA-related assets: manifest, service worker, icons, and entry points.
- Inventory dependencies on the old domain in your back-end services and third-party integrations.
- Define success metrics such as retained daily active users (DAU) or error rates.
At this stage, align business stakeholders on timing (for example, during off-peak hours) and communication plans if user-facing messaging is needed.
2. Prepare the New Origin
Next, bring the new origin to a production-ready state:
- Configure DNS and TLS/SSL certificates for the new subdomain or hostname.
- Deploy the PWA codebase to the new origin, ensuring consistent build and asset paths.
- Serve a valid web app manifest at the new origin with an appropriate
idand name matching the existing PWA identity. - Register a service worker with compatible cache strategies and update logic.
Use staging environments that mirror production as closely as possible to test installation, updates, and offline behavior from the new origin.
3. Configure Redirects and Routing
How you implement redirects from the old to the new origin can affect migration quality:
- Use HTTP 301 or 308 redirects where appropriate to signal permanent moves.
- Maintain consistent paths where possible (for example,
/app/on both origins) to simplify routing. - Avoid redirect loops or mixed-content scenarios that might interfere with service worker registration.
Ensure that the service worker on the old origin can still update during the transition window so users receive any final migration-specific logic you may deploy.
4. Test Across Devices and Chrome Versions
Because origin migration support is tied to specific browser versions, robust testing is crucial:
- Test on Chrome 150 and later on both desktop and mobile platforms.
- Validate that existing installations on the old origin behave as expected when the user next opens the app.
- Check that the PWA appears correctly under the new origin in the browser’s installed apps or app launcher UI.
For users on older browsers or other engines (Safari, Firefox, Edge variants), design a fallback experience using standard redirects and in-app messaging to guide them to the new origin.
Business Benefits of Seamless PWA Origin Migration
When implemented correctly, same-site origin migration provides tangible advantages for both technical teams and the business as a whole.
Reduced User Friction and Churn
Users keep their installed app, icon, and workflow without needing to reinstall or search for a new URL. This is especially important for:
- Subscription-based services where user retention is critical.
- Internal enterprise PWAs deployed across large workforces.
- Consumer apps with high engagement and brand loyalty.
By avoiding forced reinstallation, you preserve engagement metrics and minimize support tickets related to “missing” apps.
More Flexibility in Infrastructure and Hosting
From a technical and hosting perspective, seamless migration enables you to:
- Reorganize subdomains to better reflect architecture changes.
- Move to new hosting providers or CDNs under the same main domain with less risk.
- Adopt new security or performance best practices without sacrificing user continuity.
For organizations continuously optimizing their web hosting and performance stack, origin migration support reduces the “lock-in” effect that PWAs previously created at the domain level.
Conclusion
Changing the origin of a PWA has traditionally been a high-stakes operation, often resulting in lost installs, broken experiences, and increased user support. With features introduced in Chrome 150, businesses can now migrate PWAs between same-site origins in a way that feels seamless to users, provided they plan carefully and respect the underlying security model.
For business owners, this unlocks more strategic freedom to rebrand, consolidate domains, or modernize infrastructure. For developers, it offers a clear framework for executing technically sound migrations that preserve user trust and application integrity.
Need Professional Help?
Our team specializes in delivering enterprise-grade solutions for businesses of all sizes.