ShopiClean
✓ 7-Day Pass Active ← Back to Tools
Knowledge Base

Shopify CSV Troubleshooting Guides

Practical walkthroughs for the problems that most often stop a Shopify product import or leave products missing afterwards: header and handle errors, image rows, visibility settings, supplier feeds, unsafe updates, number formats, spreadsheet traps and file encoding. The newest guides cite Shopify’s documentation and say plainly what ShopiClean can and cannot fix.

Syntax & Parsing

How to Fix Illegal Quoting in Shopify CSVs

Resolve unescaped HTML quotes, misplaced double quotes, and line breaks that shift entire table columns into incorrect fields during import.

Read Guide →
Catalog Architecture

Split Multi-Variant Catalogs by Color

Learn how to partition massive variant matrices into standalone product listings for dedicated Google Shopping feeds and clean collection browsing.

Read Guide →
Feed Transformation

Convert Faire & Square Sheets to Shopify

Map supplier CSV headers into valid Shopify column syntax, calculate gross retail margins, and auto-generate clean handle slugs.

Read Guide →
CDN & Media

Fix Broken Image Links & Media URL Fails

Detect local workstation file paths (such as C:\), URL-encode spaces, and strip invalid parameters causing Shopify image fetch timeouts.

Read Guide →
Data Safety

Update Products by CSV Without Deleting Variants

How the overwrite option treats blank cells, missing Option columns and changed option values, and a safer export-edit-test workflow.

Read Guide →
Number Formats

Price, Weight & Inventory Formats Shopify Expects

Plain-number prices, whole-gram weights, inventory rules and what Shopify does with blank prices and quantities.

Read Guide →
Spreadsheet Traps

Fix Excel Scientific Notation in SKUs and Barcodes

Why long identifiers become 1.23E+12 or lose leading zeros, how to prevent it, and what to do when digits are already lost.

Read Guide →
File Format

Strange Characters or One Column? Fix Encoding & Separators

Save as UTF-8 with comma separators, avoid Excel regional-settings traps, and repair a catalog imported with bad characters.

Read Guide →
Import Errors

Fix “Invalid CSV Header” and “Unexpected token” Errors

What the header errors mean, why capitalization and stray spaces matter, and how to match Shopify’s template exactly.

Read Guide →
Import Errors

Fix “Options Are Not Unique” and “Handle Already Exists”

Four handle and variant errors explained: duplicate options, reused handles, rows without a title and “Line is invalid”.

Read Guide →
Visibility

Products Not Showing After a CSV Import?

How Status, Published on online store and the sales-channel option decide whether imported products are visible.

Read Guide →
Images

Add Multiple Images and Variant Images in a CSV

One row per image, image position, alt text, variant images, the 250-image limit and what makes images disappear.

Read Guide →

Guías en español y guias em português

Guides written in Spanish and Brazilian Portuguese for merchants in Latin America: Excel regional settings, number formats such as R$ 1.299,90, accents and Spanish or Portuguese column names. The ShopiClean tools themselves are in English.