All TB Loyalty & Rewards docs
  1. TB Loyalty & Rewards
  2. Docs
  3. Get started

Shopify to WooCommerce loyalty migration checklist

The order to move customers, points, store credit and gift cards from Shopify to WooCommerce so nobody loses a balance and nothing is counted twice.

Do the import twice: once a week or two before launch to test, and again on switch day with fresh exports. The second run only changes what changed, so it takes minutes and customers keep every point they earned in between.

Steps

  1. 1

    Move your customers first

    Import customers into WooCommerce with your store migration tool (Cart2Cart, LitExtension, Matrixify plus WP All Import, or your own script). Balances match by email, then by Shopify customer ID if the tool saved it in user meta.

  2. 2

    Export from each Shopify app

    Download the customer or balance export from your loyalty app, the gift card export from Shopify, and store credit if you use it. Each guide below says exactly where the export button is.

  3. 3

    Run a dry run

    In WordPress go to WooCommerce → Loyalty & Rewards → Import & Migrate, pick the source, upload the file and check the columns. The dry run shows members matched or created, points, store credit and gift card value, and any problem rows. Nothing is saved.

  4. 4

    Import, then compare totals

    Run the import. It works through the file in batches of 200 in the background, so you can leave the page. Compare the totals on the Dashboard with your Shopify app's own dashboard.

  5. 5

    Re-run on switch day

    Turn off earning in the Shopify app, export again and import the fresh files. Every row is keyed to its original ID, so changed balances are updated and nothing is counted twice.

  6. 6

    Import gift cards last

    Import Shopify gift cards after the final balances. With Pro, tick “Email customers their new gift card code” so owners get their new codes automatically.

Customers without an account

Many Shopify customers never made an account, or your migration tool didn't create one. Their balance is kept against their email address as a pending balance and attached automatically when they register or log in with the same email.

Keep the money value of points

If your new program values points differently, set the points conversion rate on the import. Example: Smile gave $1 per 100 points and you now give $1 per 50 points, so use 0.5. Customers care about what their points are worth, not the number.

Before you announce the move

  • Dashboard totals for points outstanding, store credit and gift card value match the Shopify apps.
  • A few real customers, spot-checked, have the right balance and tier.
  • Gift card owners got their new codes (Pro), or you have the list to send them yourself.
  • Earning is switched off in the Shopify apps so balances there stop moving.
Stuck on something this page doesn’t cover? Support is free for every TB Loyalty & Rewards user, Pro or not. Get help.