Skip to content
All guides

Shopify guide

How to fix Shopify CSV import errors before upload

A practical preflight checklist for handles, variants, prices, inventory, and image URLs in a Shopify product CSV.

7 min read

01

Start with a copy, not the only source

Keep the original export unchanged and work from a duplicate. Spreadsheet software can silently reinterpret identifiers, dates, and long numbers, so a recoverable source matters as much as the repair itself.

Before editing, confirm that the delimiter, encoding, header row, and line endings are consistent. Structural problems can make every later row appear invalid even when the values are correct.

  • Save the original export separately.
  • Use UTF-8 when producing CSV.
  • Keep identifiers and barcodes formatted as text.
  • Do not rename destination-defined headers casually.

02

Treat variants as a product group

Shopify product variants are related through the Handle column. A blank or inconsistent handle can split a product, attach a variant to the wrong product, or create unexpected duplicates.

Review all rows that share a handle together. Option names and values should remain structurally consistent across the group, and variant-specific fields such as SKU, price, barcode, and inventory should be checked row by row.

03

Normalize values without changing meaning

Trim accidental whitespace, normalize true and false fields to the accepted vocabulary, and make prices consistently numeric. Do not remove meaningful leading zeros from SKUs, barcodes, postal codes, or external identifiers.

Image URLs should be absolute HTTPS URLs that the destination can reach. A URL that works only inside a private dashboard or requires a signed session is not a durable import value.

04

Validate the export, not just the workbook

The file you upload is the final CSV, not the spreadsheet view. Re-open the exported file and validate that quoting, commas, newlines, formulas, and encodings survived the export.

ImportReady’s current 100-row run performs a focused subset of this preflight locally: core destination mappings, required values, unique-key duplicates, whitespace, simple comma decimals, formula-like value review, and related deterministic checks. Its Shopify output is limited to simple-product rows; repeated Handles or option columns block corrected output because grouped variants and additional images cannot yet be preserved. The source remains untouched.

Check a real file before import.

The first 100 rows are free and process locally.

Fix a file free