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

  1. 1Your CSV or Excel file
  2. 2Test run: nothing changes yet
  3. 3Your Shopify store
  4. 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 CSVBluePeacock
Files it readsCSV in UTF-8 onlyCSV, Excel and Google Sheets links, in UTF-8 or the older Windows encoding
Blank cells on updateClear the existing value when overwritingLeave the existing value unchanged
Finds existing products byURL handleProduct ID, handle or SKU
Once an import startsCan't be cancelled; no import historyCancel a running job; every job kept with its files
UndoNot describedOne-click undo from saved old values
SchedulesNot describedRun imports and exports on a schedule
Shopify column from Shopify's Help Center, read 6 November 2026.
See BluePeacock Import & Export

2How to import products to Shopify with a CSV file

Shopify's own product import works like this:

  1. 1Download Shopify's sample product CSV, or export a few products so you get your store's exact columns.
  2. 2Fill one row per product, and one extra row per variant or extra image.
  3. 3Save the file as CSV in UTF-8.
  4. 4In Shopify admin, go to Products and choose Import.
  5. 5Pick the file. Tick "Overwrite products with matching handles" only if you mean to replace existing values.
  6. 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:

ColumnWhat goes in it
Title and URL handlethe product name and its web address.
Description, Vendor, Type and Tags
Statusfor example Active or Draft.
Option1 name and Option1 valuefor example Size and Small. Up to three options.
SKU, Price and Compare-at price
Inventory quantityonly for stores with one location.
Product image URL and Image position
SEO title and SEO description
The template as a table
TitleURL handleVendorStatusSKUPriceProduct image URLImage position
Linen shirtlinen-shirtHarbor CoActiveLS-0139.00https://example.com/linen-front.jpg1
linen-shirthttps://example.com/linen-back.jpg2
Wool scarfwool-scarfHarbor CoDraftWS-0125.00https://example.com/scarf.jpg1
Two products. The third line adds a second image to the linen shirt: only the handle, image and position are filled.
Download this template (CSV)

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:

  1. 1Fill the first row with the product and its first image URL.
  2. 2Add a new row for each extra image. Fill only the URL handle and the Product image URL.
  3. 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 symptomHow 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 lettersthe file isn't UTF-8. Save it again as UTF-8.
"Invalid CSV header" or a "Choose column headings" windowa 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 importthe 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+12Excel 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:

  1. 1Open Export and choose Products, or Variants for every option, price and stock column.
  2. 2Pick the columns, including image URLs and metafields.
  3. 3Filter by status, vendor, product type, tags or created date.
  4. 4Choose CSV or Excel.
  5. 5Download the file, or on a paid plan send it to FTP, SFTP, WebDAV or Google Drive.
  6. 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 apps

13The safe way to run any big import

Whatever you move, these six steps keep your store safe:

  1. 1Export a backup of the data you are about to change. It doubles as a template whose columns match your store.
  2. 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.
  3. 3Match each column to a Shopify field.
  4. 4Review every change. BluePeacock runs a test that changes nothing and shows each record before and after.
  5. 5Run now or on a schedule. BluePeacock saves the old value of every field before it writes.
  6. 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 free

Store 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.

Keep reading