Migration guide

Migrating from WooCommerce and other platforms

Import legacy gift cards from platforms like WooCommerce, Magento, BigCommerce, or custom stores - preserving balances, expiry, and codes.

10,000
Rows per import file
0
Codes changed - originals kept
Every import
Logged with a downloadable activity log

Overview

Many merchants maintain years of gift card data in other platforms. This guide covers the common path to migrate those gift cards into Shopify without losing balances, expiration, or auditability.


Challenges

  • Migrating gift cards from legacy platforms into Shopify requires using multiple APIs or manually creating cards one by one in Shopify’s Gift Card module, making large-scale imports complex and time-consuming.

Solution

BluePeacock Gift Card Importer creates your Shopify gift cards from a single file. It checks every code, balance and expiry date first, and you can fix any row in the preview before anything is written to your store.

Implementation steps

  1. Export CSV from your legacy platform (WooCommerce, Magento, BigCommerce, POS, or custom DB).
  2. Map headers to importer standard columns using the built-in guide.
  3. Upload the file and review the preview. Fix any row flagged for its code, date or amount.
  4. Start the import and watch live progress for every card. Keep the app open until it finishes.
  5. Download the activity log to keep a record of what was created, skipped or failed.

Results

  • Original codes and remaining balances carried over exactly
  • Codes already in Shopify skipped, so no card is created twice
  • Seamless continuity for customers during relaunch

Start small: export a 10-row sample from your legacy platform and check it in the preview. Then scale up once the mapping looks right for your store.


FAQs

Quick answers to common migration questions.

Will balances and expiry dates be preserved?

Yes. Mappings align with Shopify fields. The importer validates and preserves balances and expiry dates with audit logs.

How long does a typical migration take?

It depends on the size of the export. Validate a small sample first, then run the full file - each import can carry up to 10,000 rows.

Which platforms are supported?

WooCommerce, Magento, BigCommerce, and any custom system that can export a CSV to the importer standard columns.