How to fix "invalid CSV header"
What this error means and the exact, free way to fix it — right in your browser, with nothing uploaded.
If your import fails with:
What it means
Shopify maps your data by exact, case-sensitive column names (Title, Handle, Variant Price, and so on). This error means a required header is missing or named differently than Shopify expects — for example your file has "Name" or "Product Title" instead of "Title", or "variant sku" in lower-case instead of "Variant SKU".
Common causes
- The export came from another platform (WooCommerce "Name", Amazon "item_name", Square "Item Name") whose headers don't match Shopify's.
- A header has a trailing space or different capitalization.
- The Handle or Title column is missing entirely.
How to fix it
This isn't a repair job — the columns need to be renamed and remapped to Shopify's exact schema.
- Open the free CatalogPort converter.
- Pick the platform you exported from as the source and Shopify as the target.
- It renames every column to the exact names Shopify requires (Title, Handle, Variant Price…) and you download a ready-to-import file.
Convert it to Shopify's exact format — free
The converter renames and remaps your columns to Shopify's required headers, so the "missing required header" error goes away.
Also free, in your browser: all CSV tools · the converter · Fix a CSV · Split CSV