Een Shopify CSV importeren zonder uw catalogus te breken

De Shopify CSV is tegelijk de beste en de slechtste manier om een catalogus te beheren. De beste: het is het native, officiële formaat waarmee u 10.000 producten in één keer kunt aanpassen. De slechtste: een slecht opgebouwde CSV kan uw catalogus in 3 minuten dupliceren, overschrijven of verwijderen zonder bevestiging.

Hier is de exacte structuur, de 6 kolommen die u nooit in bulk mag wijzigen, en de rollback-procedure om snel te herstellen.

De structuur van een native Shopify CSV

Exporteer een product via uw Shopify admin (Products → Export) om de officiële structuur te zien. De belangrijkste kolommen:

Kolom	Rol	Wijzigbaar in bulk?
`Handle`	Unieke identifier (= URL slug)	⚠️ Nooit
`Title`	Productnaam	✅ Ja
`Body (HTML)`	Beschrijving	✅ Ja
`Variant SKU`	Variant SKU-code	⚠️ Nooit
`Option1 Name`	Naam van de eerste variant	⚠️ Nooit
`Variant Price`	Prijs per variant	✅ Ja
`Variant Inventory Qty`	Voorraad	✅ Ja
`Image Src`	URL afbeelding	✅ Ja
`SEO Title`	SEO-titel	✅ Ja
`SEO Description`	Meta-beschrijving	✅ Ja
`Status`	`active`/`archived`/`draft`	✅ Voorzichtig

Elke regel = één SKU, geen product. Een product met 3 varianten = 3 regels die dezelfde Handle delen.

De 6 kolommen die u nooit in bulk mag wijzigen

Deze kolommen zijn de sleutels voor de integriteit van uw catalogus. Ze lichtvaardig wijzigen breekt alles:

Handle — genereert de publieke URL van het product. Een Handle wijzigen betekent: URL verandert, alle externe backlinks breken, SEO-ranking verloren.

Variant SKU — sleutel voor voorraad, WMS en analytische tools. Verstoort uw inventaris en kan verdoken duplicate varianten creëren.

Option1 Name, Option2 Name, Option3 Name — definiëren de variantstructuur. Wijzigen maakt bestaande varianten ongeldig en kan het aantal varianten laten exploderen.

Regel: wijzig deze kolommen nooit in bulk. Alleen via de admin-interface, product per product.

De 5 checks vóór upload

Check 1 — UTF-8 codering. Open de CSV in een teksteditor (VS Code, Notepad++). Controleer of accenten correct worden weergegeven. Excel slaat standaard op in latin1 — vermijd Excel voor Shopify CSV. Gebruik LibreOffice Calc, Google Sheets of VS Code.

Check 2 — Komma-scheidingsteken. Shopify CSV gebruikt komma's. In Nederlandse locales gebruikt Excel standaard puntkomma's. Als u uw gegevens in één kolom ziet bij opening, is het scheidingsteken verkeerd.

Check 3 — Escape van komma's in velden. Een beschrijving met een komma moet tussen aanhalingstekens staan, anders schuift alles op.

Check 4 — Gedupliceerde regels. Een Handle die twee keer verschijnt in de CSV = Shopify behandelt de tweede regel als variant, niet als nieuw product. Verwijder duplicaten via Data → Remove duplicates.

Check 5 — Speciale tekens in afbeeldings-URL's. Image Src moet een publieke URL zijn, toegankelijk zonder auth. Test 3-5 willekeurige URL's met curl -I — retour 200 is verplicht.

Varianten beheren zonder dupliceren

Een product met 3 varianten wordt beschreven op 3 CSV-regels:

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price
derby-leer,Derby Leer,Maat,42,DERBY-BLK-42,149.00
derby-leer,,,,,
derby-leer,,,,,

Regel 1: volledig product met Title en Option1 Name. Regels 2-3: ALLEEN de Handle en variantwaarden. Titel, Body en Vendor niet herhalen — anders beschouwt Shopify ze als wijzigingen en kan dupliceren.

Afbeeldingen: Drive vs CDN vs Shopify Files

Google Drive — ❌ werkt niet voor Shopify. Drive retourneert een HTML-pagina, geen directe afbeelding.
Publieke CDN (Cloudflare Images, S3 + CloudFront, Bunny CDN) — ✅ aanbevolen voor grote imports
Shopify Files — ✅ geschikt voor kleine catalogi (<500 afbeeldingen)

Aanbeveling: publieke CDN voor initiële import, Shopify host daarna automatisch.

Rollback vóór publicatie

Shopify biedt geen native rollback. Bereid in plaats daarvan voor:

Export vóór import — exporteer de volledige catalogus, bewaar met datumprefix
Import met status = draft — producten zijn gemaakt maar onzichtbaar op de store
Handmatige verificatie — controleer 20 willekeurige producten op afbeeldingen, varianten, prijzen
Batch publicatie na validatie
Bij ernstige schade — importeer onmiddellijk uw backup CSV, die overschrijft de huidige status

Een Shopify CSV importeren zonder uw catalogus te breken