FAQs
Gift Card Importer - Frequently Asked Questions
Quick answers to help you migrate and import gift cards into Shopify with confidence.
What CSV columns does BluePeacock support?
▼
What CSV columns does BluePeacock support?
▼The supported fields are: code, initial value, balance, expires on and note. Column names are case-sensitive and any extra columns are ignored automatically.
How does the importer handle different CSV formats?
▼
How does the importer handle different CSV formats?
▼BluePeacock Gift Card Importer automatically maps columns, date formats, and balance to match Shopify’s standard gift card structure.
How are duplicate or invalid codes handled?
▼
How are duplicate or invalid codes handled?
▼BluePeacock validates each code before import. Duplicates or invalid entries are skipped, and every skipped record is clearly listed in the import summary. This ensures your Shopify store remains clean and consistent.
What’s the row or file size limit?
▼
What’s the row or file size limit?
▼Each file can be up to 10 MB and 10,000 rows. For larger migrations, split your gift cards into files of 10,000 rows or fewer and import them one after another. Contact us for help if you are migrating from several sources or a very large dataset.
How long does an import take?
▼
How long does an import take?
▼Gift cards are created one by one through Shopify, and you can watch live progress for every card. The summary shows how many were created, skipped because the code already exists, expired or failed. Imports do not run in the background, so keep the app open until the import finishes.
Can I preview or test before importing live data?
▼
Can I preview or test before importing live data?
▼Yes, you can preview everything before anything is written. The app reads your file and checks every row: codes must be 8–20 letters or numbers, amounts must be valid, expiry dates must be real dates, and no code may repeat inside the file. You can fix rows right in the preview or export the errors. Nothing is created in Shopify until you start the import. The preview does not check against gift cards already in your store; those codes are skipped safely during the import.
What happens if an import fails midway?
▼
What happens if an import fails midway?
▼Gift cards created before the stop stay in your store. Imports do not resume on their own, but you can import the same file again. Codes that already exist in Shopify are skipped, so no card is created twice. The import summary and downloadable activity log show which rows succeeded, were skipped or failed, and why.
Can I rollback or reimport specific batches?
▼
Can I rollback or reimport specific batches?
▼No. Shopify does not support deleting gift cards.
Where can I find help or documentation?
▼
Where can I find help or documentation?
▼Visit our Help Document for setup guides and troubleshooting. You can also reach support directly from your Shopify app dashboard - we reply within 24 hours.