Home / tutorials

Migration tutorials.

Written walkthroughs of every step you'll actually touch. (Video versions are in production — these stay the canonical reference.)

1 · Prepare your two stores

  1. Keep your current store exactly as it is — we only ever read from it.
  2. Create the destination store if you don't have one: shopify.com → start free trial → any theme (yours moves over anyway). You don't need to pick a paid plan until cutover.
  3. Have your custom domain registrar login handy for cutover day (Complete and up — we schedule it with you).

2 · Create the API access tokens (≈3 minutes per store)

  1. Store admin → Settings → Apps and sales channels → Develop apps → Create app — name it migration.
  2. Configure Admin API scopes: on the OLD store tick the read scopes; on the NEW store tick read + write. Save.
  3. Install app → reveal the Admin API access token (shpat_…) → paste it into your customer area. Never email tokens.
  4. After your migration completes: delete the app on both stores. Access gone, permanently.

3 · Read your verification report

  1. Counts table — every entity, source vs destination. They match or the line is flagged.
  2. Spot checks — sampled products compared field-by-field: prices, variants, media, metafields.
  3. Reference integrity — every reference metafield on the new store resolves to a live object.
  4. The second pass — the whole migration re-ran and created zero records. That line is your proof.
  5. Named exceptions — anything no API can move (gift-card codes → replacements CSV) is itemized with its workaround.

4 · Cutover day

  1. Approve the verification report in your customer area.
  2. We publish the migrated theme and re-run the publications sync (sales channels go live).
  3. DNS switches to the new store (we schedule and walk it with you on Complete and up).
  4. Confirm checkout with a real test order, then revoke both API tokens.
  5. Keep the old store paused for 30 days as a safety net — then close it.

Ready? See packages →