All TB Loyalty & Rewards docs
- TB Loyalty & Rewards
- Docs
- 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
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
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
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
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
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
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.