Ecommerce Migration Strategy: How to Plan a Store Migration
How to plan an ecommerce platform migration: goals and scope, data, URLs and SEO, customer data, analytics, rehearsals, cutover, rollback and workstreams.
Quick answer
A safe ecommerce platform migration protects two things: search visibility and customer data. Build a full inventory and baseline; map every data type and every indexable URL to the new platform; rehearse the migration on staging with production-like data; implement one-to-one 301 redirects and carry over metadata, content, canonicals and structured data; migrate customers, consents, order history, subscriptions and payment tokens through proper channels; freeze changes, cut over, test and monitor closely with a defined rollback plan. Most migration damage comes from unmapped URLs and incomplete data, not from the platform itself.
Where Migrations Go Wrong
Platform migrations fail in predictable ways: product and category URLs change without redirects, titles and descriptions are lost, internal links point to redirected URLs, structured data disappears, analytics tracking breaks, customers can't sign in, subscriptions stop billing and order history vanishes. None of these are platform problems; they're planning problems. The flow above shows a sequence that avoids them. For deciding whether to replatform at all, see ecommerce replatforming.
Phase 1: Inventory and Baseline
Before touching the new platform, record what exists and how it performs. Crawl the current site for every URL and its status, title, description, canonical and structured data; export analytics and search performance by page; list every data type and integration; and record current conversion, revenue and organic traffic by page type. This baseline is how you'll know whether the migration worked.
- Full crawl of indexable URLs with metadata
- Search Console performance by page
- Analytics traffic, conversion and revenue by page type
- Backlink targets (pages other sites link to)
- Data types, volumes and quality issues
- Integrations and scheduled jobs
Phase 2: Map Data
Every platform models data differently. Map each source entity and field to the target: products, variants and options; collections and categories; customers and addresses; orders; reviews; content pages and blog posts; redirects; gift cards; loyalty balances; subscriptions. Decide what's migrated, transformed, archived or left behind, and clean data before import rather than after.
| Data | Typical approach | Watch out for |
|---|---|---|
| Products and variants | Import with IDs mapped | Option limits, variant structure differences |
| Categories and collections | Recreate with URL mapping | Rule-based vs manual membership |
| Customers | Import with consent status | Passwords usually can't migrate |
| Orders | Import historical orders or archive | Needed for service, reorders, analytics |
| Reviews | Import via review platform | Keep product associations |
| Subscriptions | Migrate contracts and payment tokens | Billing continuity |
| Gift cards and loyalty | Migrate balances | Liability and customer trust |
Phase 2: Map URLs
Create a URL map from every old indexable URL to its new equivalent: products to products, categories to categories, content to content. Where a page has no equivalent, redirect to the closest relevant page, not the homepage. Keep URLs unchanged where the new platform allows; every change is a risk. Watch for platform-imposed URL patterns (for example fixed prefixes for products and collections) that force changes.
| Old URL | New URL | Type |
|---|---|---|
| /shop/linen-shirt-blue | /products/linen-shirt?variant=blue | 301, product |
| /category/mens-shirts | /collections/mens-shirts | 301, category |
| /blog/how-to-care-for-linen | /blogs/journal/how-to-care-for-linen | 301, content |
| /discontinued-product | /collections/mens-shirts | 301, closest relevant |
Preserve On-Page SEO Signals
Carry over titles, meta descriptions, headings, body content, image alt text, canonical tags and structured data for every mapped page. Check that the new templates don't introduce duplicate content (for example products reachable through several collection paths without canonicals), that faceted navigation is controlled and that internal links point directly at final URLs rather than through redirects. See product structured data and faceted navigation SEO.
Planning a platform migration?
ZSpace plans and runs ecommerce migrations with URL mapping, data validation and post-launch monitoring built in.
Customer Data
Customer data carries legal and trust obligations. Migrate customer records with consent and marketing preferences intact, addresses, and order history where it's needed for service and reorders. Passwords are usually stored as hashes the new platform can't use: Shopify, for example, doesn't import customer passwords, so customers need to set new passwords or use passwordless sign-in. Plan clear communication. Never export raw card data; payment tokens can only move between payment providers through their supported processes. Review data protection requirements for the transfer.
Subscriptions and Payment Tokens
Subscriptions are the highest-risk data in many migrations, because billing must continue without customers re-entering details. That depends on migrating stored payment method tokens between providers or accounts, which providers handle through specific processes with security requirements. Plan it early, test renewals on migrated contracts before cutover, and communicate with subscribers. See subscription ecommerce website development.
Analytics and Tracking
Recreate the measurement plan on the new platform: page views, product views, add to cart, checkout steps, purchases with the same definitions, consent handling and campaign attribution. Test events before launch and annotate the launch date in analytics. Keep the old tracking data accessible for comparison. See ecommerce analytics.
Phase 3: Rehearse
Run at least one full rehearsal: migrate production-like data to staging with the actual scripts, time each step, validate counts and samples, test the storefront, checkout, emails and integrations, and crawl the staging site for redirects, metadata and broken links. Rehearsals reveal slow imports, data mapping errors and missing redirects when they're still cheap to fix.
Phase 4: Freeze and Cut Over
Agree a change freeze on the old platform (no new products or content) before cutover, or a process for capturing late changes. During cutover: final delta migration of orders and customers, redirects activated, DNS switched, integrations pointed at the new platform, and test orders placed. Choose a low-traffic window and have the team available.
Phase 5: QA and Monitoring
- Crawl the live site: redirects, status codes, canonicals, metadata
- Test old URLs from the map and top backlinks
- Submit new sitemaps; watch crawl errors in Search Console
- Compare organic traffic and rankings by page type with baseline
- Check conversion, checkout errors and payment success
- Verify customer sign-in, order history and subscriptions
- Reconcile orders between platform, ERP and payment provider
Rollback Planning
Decide in advance what would trigger a rollback (for example checkout failures or severe data problems), how DNS and redirects would be reversed, how orders placed on the new platform would be reconciled, and who decides. Most migrations never roll back, but having the plan makes the cutover calmer and faster when problems appear.
Worked Example: Migrating a Mid-Size Store
An illustrative scenario, not a client case: a store with 4,000 products, 60,000 customers and subscriptions moves platforms. The team crawls 9,000 indexable URLs, maps each to a new URL (keeping product slugs where possible), migrates products, customers with consent status, three years of orders and subscription contracts, and works with the payment providers to migrate stored payment tokens. Two rehearsals find variant-structure issues and 300 unmapped blog URLs. At cutover, redirects go live with DNS, customers receive an email explaining password reset, and the team monitors crawl errors, conversion and subscription renewals daily for the first weeks.
Migration Goals and Scope
Start by writing down why you're migrating and what must improve: lower maintenance, better performance, new capabilities, lower cost, integration needs. Goals decide scope: a like-for-like platform move, a redesign at the same time, or restructuring the catalog and URLs. Each additional change adds risk and makes results harder to interpret, so add scope deliberately. For choosing the destination, see ecommerce replatforming.
| Scope | Risk | When it makes sense |
|---|---|---|
| Platform only (like for like) | Lowest | Platform is the constraint; design works |
| Platform + design refresh | Medium | Design also limits conversion |
| Platform + restructure catalog and URLs | Highest | Structure is fundamentally wrong |
The Migration Workstreams
A migration runs several workstreams in parallel, each with its own guide: migration checklist, data migration, SEO migration, URL migration, migration testing, parallel runs and the launch plan. For moves to Shopify, see Shopify migration.
Common Mistakes
- No baseline to compare against
- Redirecting everything to the homepage
- Losing metadata and structured data
- Internal links pointing through redirect chains
- Assuming passwords and payment tokens will migrate
- No rehearsal
- Launching at peak trading
- Stopping monitoring after launch day
Ready to migrate without losing search visibility or customers?
Talk to ZSpace about ecommerce migrations and migrating to Shopify.
Conclusion
Platform migrations succeed on preparation: a baseline, complete data and URL maps, rehearsals, careful handling of customer data and payment tokens, and disciplined monitoring after launch. For the Shopify-specific process, see Shopify migration, and for general website migrations, website migration guide.
Common questions
Moving a store's data, URLs, content, integrations and customers from one ecommerce platform to another. It's the execution phase of a replatforming decision.