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, note . Column names are case-sensitive and any extras 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?
▾Imports of up to 10,000 gift cards typically run smoothly. For larger migrations (20,000–50,000+), Split the CSV into smaller batches and import these CSVs separately. Contact us for assistance if migrating from multiple sources or large datasets.
How does BluePeacock Gift Card Importer handle Shopify API rate limits?
▾
How does BluePeacock Gift Card Importer handle Shopify API rate limits?
▾Shopify enforces API call limits to maintain store stability. BluePeacock uses intelligent batching and throttling to stay within these limits while maximizing speed. Each batch of requests is queued, retried on timeout, and resumed automatically to prevent partial imports.
Can I preview or test before importing live data?
▾
Can I preview or test before importing live data?
▾Yes. BluePeacock performs a full dry-run simulation before writing any data. The dry-run parses and validates your CSV, checks for duplicates, formats, and potential conflicts — without creating any gift cards in Shopify. This gives you full visibility and confidence before import.
What happens if an import fails midway?
▾
What happens if an import fails midway?
▾Every import job is tracked and resumable. If a batch fails due to rate limits or network issues, You can also re-run only failed rows without duplicating successful ones by using the same CSV file. This ensures your data is not lost and you can continue from where you left off. Before importing, the app will show what gift card row has issues 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 — our response time is typically under one business day.