Skip to content
Web Development

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.

DataTypical approachWatch out for
Products and variantsImport with IDs mappedOption limits, variant structure differences
Categories and collectionsRecreate with URL mappingRule-based vs manual membership
CustomersImport with consent statusPasswords usually can't migrate
OrdersImport historical orders or archiveNeeded for service, reorders, analytics
ReviewsImport via review platformKeep product associations
SubscriptionsMigrate contracts and payment tokensBilling continuity
Gift cards and loyaltyMigrate balancesLiability 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 URLNew URLType
/shop/linen-shirt-blue/products/linen-shirt?variant=blue301, product
/category/mens-shirts/collections/mens-shirts301, category
/blog/how-to-care-for-linen/blogs/journal/how-to-care-for-linen301, content
/discontinued-product/collections/mens-shirts301, 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.

Start a Project

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.

ScopeRiskWhen it makes sense
Platform only (like for like)LowestPlatform is the constraint; design works
Platform + design refreshMediumDesign also limits conversion
Platform + restructure catalog and URLsHighestStructure 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.

Start a Project

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.

FAQ

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.

Get in touch

Have a project in mind?

Whether you're building a new digital product, improving an existing website, or looking to automate part of your business — let's talk.