All Posts Commerce

The Shopify Plus Migration Playbook: Zero Downtime, Zero Data Loss

December 1, 202510 min readContra Collective
🛒

Platform migrations have a well deserved reputation for going wrong. They take longer than planned, lose data in transit, tank search rankings, and occasionally bring down a brand's revenue for days. Migrations from Magento 1, Magento 2, BigCommerce, WooCommerce, SFCC, and custom platforms all follow predictable failure patterns and equally predictable ways to prevent them.

This is the playbook.

The Foundation: Treat Every Migration Like Surgery

The mindset that prevents migration disasters: treat the production store as a patient on an operating table. The goal is to complete the procedure without unexpected complications, and to have the patient fully recovered by the time they leave. Every step is deliberate, every action is logged, and the surgical team is aligned before the first incision.

That means:

  • No improvisation on migration day
  • Every step executed by two people (one acting, one verifying)
  • Rollback plan ready and tested before cutover
  • Operations team briefed and on standby

Phase 1: Discovery (Weeks 1-2)

Before moving anything, build a complete inventory.

Data Inventory

Document every object type that needs to migrate:

  • Products: Variant count, metafields, custom attributes, image/video assets
  • Customers: Account types, address count, loyalty points (if applicable)
  • Orders: Historical order count, period coverage, fulfillment statuses
  • Content: Pages, blog posts, navigation menus, redirects
  • Discount codes: Types, usage limits, expiration dates, usage counts
  • Gift cards: Remaining balances

For each object type, document the source schema and map it to the Shopify schema. Identify fields with no direct mapping (these are your migration complexity hotspots).

SEO Asset Inventory

Run a full crawl of the source site with Screaming Frog:

  • Every indexed URL with its current title, meta description, and canonical
  • Internal link count (identifies high authority pages)
  • Structured data markup in place
  • Core Web Vitals baseline (Google PageSpeed)

Pull Google Search Console data:

  • Top 100 pages by organic traffic
  • Search queries and current positions
  • Current impressions and clicks baseline

This SEO snapshot is your before state. You'll compare it against the post migration state to catch any issues before they compound.

Integration Inventory

List every system connected to the current platform:

  • ERPs and inventory management systems
  • Email marketing (Klaviyo, Mailchimp)
  • Customer service platforms (Gorgias, Zendesk)
  • Analytics (GA4, Segment)
  • Reviews (Yotpo, Okendo)
  • Loyalty (LoyaltyLion, Smile)
  • Payment gateways
  • Tax compliance (Avalara, TaxJar)

For each integration, identify the migration work required: reconfiguration, new app installation, or custom API reconnection.

Phase 2: Destination Build (Weeks 3-8)

Build the Shopify Plus store in parallel. The source store continues operating normally throughout.

Theme Development

The theme is built against your complete product catalog and tested with real data. Specific areas to test:

  • Product page rendering for edge cases (products with 200+ variants, products with no images, products with custom metafield data)
  • Collection page performance with large catalogs
  • Search functionality and filters
  • Mobile experience across iOS and Android

Data Migration Pipeline

Build and test the migration scripts against a staging environment:

  1. Export all product data from source platform via API or database export
  2. Transform data to Shopify's schema using custom scripts
  3. Import to Shopify via the Admin API (using bulk operations for large catalogs)
  4. Validate: compare record counts and spot check individual records for accuracy

Run this pipeline repeatedly. By migration day, you should have run it 5+ times and refined any edge cases.

301 Redirect Map

Build a complete redirect map: every source URL to the corresponding Shopify URL. For large sites, this is automated: extract all source URLs, map to Shopify URL patterns (product handle, collection handle, page handle), validate that the destination URLs exist.

Test the redirect map before cutover by running the full source URL list against the staging environment.

Phase 3: Parallel Testing (Weeks 9-10)

Run the destination store in shadow mode: real data, no customer traffic.

Functional Testing Matrix

Test everything:

  • All payment methods (credit card, Shop Pay, Afterpay, PayPal)
  • All discount types and code formats
  • Gift card redemption
  • Customer account login, registration, order history
  • Checkout with every combination of shipping options
  • All third party app integrations

Sign off on each item. Nothing goes live with open issues.

Performance Testing

Run Lighthouse and PageSpeed against the destination store and compare to the source baseline. If performance regresses significantly on key pages, investigate before cutover.

Phase 4: Cutover

Plan for a 2 to 4 hour maintenance window during your lowest traffic period (typically 2 to 5am in your primary market).

Cutover Checklist

  1. Final data sync: Export all records created since last migration run, import to Shopify
  2. Enable maintenance mode on source store
  3. Final validation: Verify record counts match
  4. DNS cutover: Update A/CNAME records with short TTL (300 seconds)
  5. SSL verification: Confirm Shopify SSL certificate is active for your domain
  6. Smoke test: Add to cart, checkout, verify payment on the live store
  7. Monitor: Watch error rates, order volume, and checkout conversion for 30 minutes
  8. All clear: Brief operations team that migration is complete

If any critical issue is found during the maintenance window, DNS rollback is possible within 5 minutes.

Phase 5: Post Migration (Days 1-30)

First 48 Hours

  • Watch Google Search Console for crawl errors (check hourly)
  • Monitor Shopify's order flow and checkout conversion vs. baseline
  • Review customer service inbox for migration related issues

Weeks 1-4

  • Check GSC weekly for ranking changes on top 100 organic pages
  • Monitor site speed (PageSpeed Insights) for any regression
  • Run a fresh crawl and compare to pre migration crawl for redirect compliance

Most SEO impact from well executed migrations is temporary. With proper redirects and continued optimization, rankings typically recover within 4 to 8 weeks.

More from the Lab

🛒Commerce
Commerce

Gorgias vs Zendesk: Customer Support Platforms for Shopify Stores

Customer support used to be a cost center. The best e-commerce brands in 2026 treat it as a revenue channel. That reframe changes which platform you should choose.

Apr 5, 2026
🛒Commerce
Commerce

Klaviyo vs Omnisend: Email Marketing for E-commerce Brands in 2026

Choosing the wrong email platform costs you more than monthly subscription fees. It costs you revenue per send, compounding over every campaign and flow you run for years.

Apr 5, 2026
🛒Commerce
Commerce

The Cost of 'Custom': When to Choose Magento Over SaaS Platforms

Every enterprise commerce decision eventually collides with the same uncomfortable question: are you paying for flexibility, or paying because of inflexibility? Shopify Plus has closed the gap on a lot of functionality over the last three years: checkout extensibility, B2B APIs, multi market support. But there's a class of business requirements where SaaS platforms still fundamentally break down, and understanding that boundary is the difference between a successful implementation and a painful mid migration two years from now. The debate over when to use Magento over Shopify isn't philosophical. It's architectural.

Mar 21, 2026

Want to discuss this topic?

Start a Conversation