Shopify CSV unknown error diagnosis
Shopify CSV Import Unknown Error
An unknown import error means Shopify hit something it could not parse or explain clearly. EcomCSVFix checks corrupt rows, line endings, file size, invisible characters, and common CSV structure problems automatically.
What causes this error
- The CSV is corrupt or truncated mid-row, often from an interrupted export or failed download.
- The file has mixed line endings, such as CRLF and LF in the same CSV.
- The file is too large for Shopify's product CSV import limit of 15MB.
- Cells contain invisible characters such as zero-width spaces, non-breaking spaces, or hidden control characters.
How to fix it
Option A: fix it manually
- Check the file size before upload; if it is over 15MB, split it into smaller product CSV imports.
- Open the file in Notepad++, VS Code, or a hex editor and inspect line endings and invisible characters.
- Search for hidden characters such as zero-width spaces and non-breaking spaces, especially in Handle, Title, Tags, and Body (HTML).
- Re-export the CSV from the original source if the file appears truncated, has ragged rows, or ends mid-product.
Option B: fix it automatically
- Upload the CSV and EcomCSVFix scans for hidden characters, broken rows, and structural import blockers.
- Download a cleaned CSV or use the report to identify the remaining row that needs source-data repair.
Before and after
Handle,Title,Variant Price
blue-t-shirt\u200B,Blue T-Shirt,19.99Handle,Title,Variant Price
blue-t-shirt,Blue T-Shirt,19.99Fix it automatically in 30 seconds
Upload your CSV, let EcomCSVFix repair the broken rows, then download a Shopify-ready file.
Free for up to 5 files/month. No credit card.
FAQ
Why does Shopify show an unknown CSV error?
Shopify uses unknown error messaging when the importer cannot map the failure to a friendly row or field message. It often points to corrupt structure, invisible characters, or size limits.
What is a zero-width space?
A zero-width space is an invisible character that can be pasted from websites, supplier feeds, or documents. It can make a handle or header look correct while its actual value differs.
What is Shopify's CSV file size limit?
Shopify's product CSV import limit is commonly 15MB. Larger files should be split into smaller imports.
Should I re-export the file?
Yes, if the CSV is truncated, has mixed row widths, or ends mid-row. Re-exporting from the original source is safer than manually patching a corrupt file.