Shopify bulk import and export: CSV guide, templates, fixes
This guide covers the common ways to bulk import and export Shopify data: Shopify's own CSV import, a ready-to-copy column template, fixes for CSV imports that fail, and how to move products, images, metafields, orders and customers.
Bulk changes are the fastest way to update a store. They are also the fastest way to break one, because one wrong column can touch thousands of records. So every method here starts with a backup and ends with a way back.
By the BluePeacock team10 min read
- 1Your CSV or Excel file
- 2Test run: nothing changes yet
- 3Your Shopify store
- Undo in one click
Key takeaways
Shopify's admin imports products and customers from UTF-8 CSV files up to 15 MB. This guide gives you the columns, a template, fixes for the common errors, and a safe way to run big imports and exports.
- Start from an export of your own store: it has every column in the right order.
- Save as CSV UTF-8, spell headers exactly as Shopify does, and use public https image links.
- With overwrite on, Shopify clears a value when its cell is blank. Leave a column out instead.
- Shopify's Help Center, read on 6 November 2026, describes no order import and no undo.
- Test every big import first and keep a backup export, so a mistake can be reversed.
1Two ways to bulk import and export Shopify data
Shopify's admin has a free CSV tool. Shopify's Help Center, read on 6 November 2026, it imports products and customers from CSV files and exports products, customers and orders. It suits small product files that you build with care.
| Shopify admin CSV | BluePeacock | |
|---|---|---|
| Files it reads | CSV in UTF-8 only | CSV, Excel and Google Sheets links, in UTF-8 or the older Windows encoding |
| Blank cells on update | Clear the existing value when overwriting | Leave the existing value unchanged |
| Finds existing products by | URL handle | Product ID, handle or SKU |
| Once an import starts | Can't be cancelled; no import history | Cancel a running job; every job kept with its files |
| Undo | Not described | One-click undo from saved old values |
| Schedules | Not described | Run imports and exports on a schedule |
2How to import products to Shopify with a CSV file
Shopify's own product import works like this:
- 1Download Shopify's sample product CSV, or export a few products so you get your store's exact columns.
- 2Fill one row per product, and one extra row per variant or extra image.
- 3Save the file as CSV in UTF-8.
- 4In Shopify admin, go to Products and choose Import.
- 5Pick the file. Tick "Overwrite products with matching handles" only if you mean to replace existing values.
- 6Upload the file and start the import.
3Shopify CSV import limits to know first
Shopify's Help Center, read on 6 November 2026, sets these rules:
4Shopify product CSV template: the columns you need
Shopify's current sample file starts with Title and URL handle. The URL handle ties each row to one product, so every row that shares a handle belongs to the same product. Headers must match Shopify's spelling exactly.
Most product imports only need these columns:
| Column | What goes in it |
|---|---|
| Title and URL handle | the product name and its web address. |
| Description, Vendor, Type and Tags | |
| Status | for example Active or Draft. |
| Option1 name and Option1 value | for example Size and Small. Up to three options. |
| SKU, Price and Compare-at price | |
| Inventory quantity | only for stores with one location. |
| Product image URL and Image position | |
| SEO title and SEO description |
| Title | URL handle | Vendor | Status | SKU | Price | Product image URL | Image position |
|---|---|---|---|---|---|---|---|
| Linen shirt | linen-shirt | Harbor Co | Active | LS-01 | 39.00 | https://example.com/linen-front.jpg | 1 |
| linen-shirt | https://example.com/linen-back.jpg | 2 | |||||
| Wool scarf | wool-scarf | Harbor Co | Draft | WS-01 | 25.00 | https://example.com/scarf.jpg | 1 |
5How to import multiple images per product
Shopify's Help Center, read on 6 November 2026, a product can have up to 250 images. Each image needs its own row:
- 1Fill the first row with the product and its first image URL.
- 2Add a new row for each extra image. Fill only the URL handle and the Product image URL.
- 3Set Image position to 1, 2, 3 so the images show in that order.
6How to import metafields with a CSV
Shopify's product CSV takes product metafields as extra columns. The header names the metafield, for example "Fabric (product.metafields.custom.fabric)". Shopify's Help Center, read on 6 November 2026, variant metafields aren't supported, and the customer CSV takes only a few simple metafield types.
7Shopify CSV import not working? Common errors and fixes
These errors and fixes come from Shopify's Help Center, read on 6 November 2026, plus one Excel habit that causes many problems:
| Error or symptom | How to fix it |
|---|---|
| "Illegal quoting" or "Missing or stray quote" | Excel added curly quotes, or the file isn't UTF-8. Save as CSV UTF-8 and replace curly quotes with straight ones. |
| Odd symbols in place of accented letters | the file isn't UTF-8. Save it again as UTF-8. |
| "Invalid CSV header" or a "Choose column headings" window | a header is misspelt or has a trailing space. Headers are case-sensitive, so copy them from Shopify's sample file. |
| "An error occurred while trying to download the image" | the image URL isn't public or doesn't start with http:// or https://. |
| "Ignored line … because it did not contain product data" | a row has a handle but no title. |
| "Options are not unique" | two variants share the same option values. |
| "Price can't be blank" or "Inventory quantity is not a number" | fill the cell with a plain number. |
| Images disappear after an import | the file was sorted in Excel, which Shopify warns can break image links. Don't sort a product file. |
| Barcodes turn into numbers like 4.00638E+12 | Excel rounded them. Format the column as Text before you paste. |
8How to export Shopify products to CSV or Excel
Shopify's admin exports products as CSV only. Shopify's Help Center, read on 6 November 2026, CSV in UTF-8 is the only format it can import or export, and the Collection column isn't included in an export.
With BluePeacock you choose the format and the columns:
- 1Open Export and choose Products, or Variants for every option, price and stock column.
- 2Pick the columns, including image URLs and metafields.
- 3Filter by status, vendor, product type, tags or created date.
- 4Choose CSV or Excel.
- 5Download the file, or on a paid plan send it to FTP, SFTP, WebDAV or Google Drive.
- 6Run it now, later, or on a repeat schedule such as a weekly backup.
9How to export Shopify orders
In Shopify admin, open Orders and choose Export. Shopify's Help Center, read on 6 November 2026, up to 50 orders download straight away, and a bigger export is sent to you by email.
10How to import and export customers
Shopify's customer CSV takes names, email, phone, one default address, marketing consent, tags, a note and tax exemption. Shopify's Help Center, read on 6 November 2026, the file can be up to 15 MB, duplicate emails or phone numbers are skipped, and passwords can't be moved.
11Can you import orders into Shopify?
Not with Shopify's admin. Shopify's Help Center, read on 6 November 2026, describes order export but no order import.
To bring order history over, you need an app that creates orders. BluePeacock imports orders and draft orders from CSV or Excel. Matrixify's Shopify App Store page, read on 6 November 2026, also lists order import.
12How to import products from another store
From WooCommerce: on a paid plan, connect your store with its address and API keys, and BluePeacock reads its products. Or export a product CSV from WooCommerce and import that file on any plan.
From any other platform: export a product CSV, then match its columns to Shopify fields. BluePeacock suggests close matches but never guesses for you.
From another Shopify store: export products from one store and import the file into the other.
Compare Shopify migration and import apps13The safe way to run any big import
Whatever you move, these six steps keep your store safe:
- 1Export a backup of the data you are about to change. It doubles as a template whose columns match your store.
- 2Prepare the file. Include an identity column, such as a product ID, handle or SKU, so records are updated, not duplicated. Leave a cell blank when you don't want to change it: BluePeacock leaves blank cells alone.
- 3Match each column to a Shopify field.
- 4Review every change. BluePeacock runs a test that changes nothing and shows each record before and after.
- 5Run now or on a schedule. BluePeacock saves the old value of every field before it writes.
- 6Undo if something went wrong. Open the job and the saved old values go back in one click. Images you removed can't come back, because Shopify deletes the files.
A test run catches the mistake before it reaches your store. Saved old values and one-click undo fix the ones that slip through. And if you get stuck, a person at BluePeacock answers within 24 hours.
Try BluePeacock Import & Export freeStore settings, customer data and backups you can move
- Shop policies
- Import and export refund, privacy, terms of service and shipping policies.
- Shipping setup
- Import and export shipping profiles, zones and rates.
- Customer segments
- Import and export customer segments.
- Theme file backups
- Export theme files as a dated backup. Importing theme files needs special permission from Shopify.
- Inventory transfers
- Import and export inventory transfers between locations.
- Subscription and pre-order plans
- Export subscription and pre-order selling plans.
- Shopify Markets
- Import and export your Markets setup.
- Store credit
- Export customer store credit balances.
- Abandoned checkouts
- Export only. Requires Shopify approval for access to protected customer data.
- Gift cards
- Moving gift cards? The BluePeacock Gift Card Importer brings them into Shopify with their original codes and balances.
Shopify import and export questions
How do I bulk import products to Shopify?
Make a CSV file with one row per product, variant or extra image, save it as UTF-8, then go to Products and choose Import in Shopify admin. For Excel files, a test run before writing and one-click undo, use an import app such as BluePeacock Import & Export.
Where can I get a Shopify product CSV template?
Shopify's Help Center links a sample product CSV. A faster start is to export one of your own products: the file has every column in the order your store uses.
Why is my Shopify CSV import not working?
The usual causes are a file not saved as UTF-8, curly quotes added by Excel, a misspelt column header, or an image URL that isn't public. Each one has a fix in the error list in this guide.
What is the file size limit for a Shopify CSV import?
Shopify's Help Center, read on 6 November 2026, says product and customer CSV files can't be larger than 15 MB. Split bigger files.
Can I import metafields with a Shopify CSV?
Yes, product metafields go in extra columns named after the metafield, for example "Fabric (product.metafields.custom.fabric)". Shopify's Help Center, read on 6 November 2026, says variant metafields aren't supported. Create the metafield definition before you import.
How do I add multiple images to one product in a CSV?
Add one row per image. Fill only the URL handle and the Product image URL on each extra row, and set Image position to choose the order. Each URL must be public.
Can I import orders into Shopify?
Not with Shopify's admin: its Help Center, read on 6 November 2026, describes order export but no order import. You need an app that creates orders. BluePeacock imports orders and draft orders.
How do I export Shopify products to Excel?
Shopify's admin exports CSV, which Excel opens. To get a real Excel file with the columns you choose, export with BluePeacock and pick Excel as the format.
Can I undo a Shopify CSV import?
Shopify's Help Center, read on 6 November 2026, says an import can't be cancelled once it starts and describes no undo. BluePeacock saves the old value of every field before it writes, so a finished import can be undone in one click.
About this guide
Written by the BluePeacock team, who build Shopify apps for bulk data and gift cards. Every Shopify fact here was checked against Shopify's Help Center on 6 November 2026.