De Shopify product-CSV-indeling zet productgegevens in een spreadsheet. Elke rij beschrijft een product, een variant of een extra afbeelding. Elke kolom bevat één soort gegevens, zoals de titel, prijs of SKU.
De ingebouwde importer van Shopify verwacht zijn eigen kolomnamen. Simple CSV kan bronkolommen met andere namen aan Shopify-velden koppelen voordat een import start.
Hoe rijen en kolommen samenwerken
De eerste rij bevat de kolomkoppen. Het huidige sjabloon van Shopify gebruikt koppen zoals Title, URL handle en Price. Oudere Shopify-exports gebruiken koppen zoals Handle, Body (HTML) en Variant Price. Shopify blijft oudere koppen ondersteunen. Het bestand dat je exporteert kan er dus anders uitzien dan een nieuwer sjabloon.
Voor een nieuw product zonder varianten vraagt Shopify alleen een titel. Een URL handle is ook verplicht wanneer het product varianten heeft. Voor een update via de ingebouwde importer van Shopify neem je de titel en de URL handle op. De handle is het deel aan het einde van het adres van de productpagina, zoals canvas-backpack in /products/canvas-backpack.
Houd de koppen aan van het sjabloon of de export waarmee je bent begonnen. Hernoem niet slechts een deel ervan en meng geen twee sjabloonversies in één bestand. De referentietabellen hieronder gebruiken de huidige koppen van Shopify. Een aparte tabel toont hun oudere equivalenten.
Productkolommen
Deze kolommen beschrijven het product dat alle varianten delen. Zet de gedeelde gegevens op de eerste rij van dat product.
| Kolom | Wat je invult |
|---|---|
| Title | De productnaam die klanten zien. |
| URL handle | Een unieke waarde van letters, cijfers en streepjes, zonder spaties. Elke variant van één product deelt deze waarde. |
| Description | De productbeschrijving. HTML is toegestaan. |
| Vendor | De naam van het merk, de maker of de leverancier. |
| Product category | Een categorie uit de standaard productlijst van Shopify. |
| Type | Je eigen producttype voor de organisatie van je winkel. |
| Tags | Tags gescheiden door komma’s. Zet de hele cel tussen aanhalingstekens als de cel komma’s bevat. |
| Published on online store | true of false. Dit bepaalt de publicatie naar de Online Store. |
| Status | active, draft of archived in het eigen formaat van Shopify. |
| SEO title | De titel die zoekmachines gebruiken. |
| SEO description | De beschrijving die zoekmachines gebruiken. |
De optionele kolom Collection is een speciaal geval in de ingebouwde importer van Shopify. Deze kolom kan een product tijdens de import aan één collectie toevoegen. Shopify neemt deze kolom niet op in productexports, en andere aangepaste kolommen kunnen het eigen formaat breken.
Kolommen voor varianten, prijzen en voorraad
Een variant is één versie van een product, bijvoorbeeld een blauw T-shirt in maat medium. Elke variant krijgt een eigen rij.
| Kolom | Wat je invult |
|---|---|
| Option1 name en Option1 value | De eerste keuze en waarde, bijvoorbeeld Size en Medium. |
| Option2 name en Option2 value | Een tweede keuze, bijvoorbeeld Color en Blue. |
| Option3 name en Option3 value | Een derde keuze als het product die nodig heeft. |
| SKU | Je artikelnummer voor deze variant. Houd elke SKU uniek. |
| Price | De verkoopprijs als getal, zonder valutasymbool. |
| Compare-at price | De hogere originele prijs om een korting te tonen. |
| Barcodes | Eén barcode of meerdere barcodes gescheiden door puntkomma’s. |
| Inventory tracker | Gebruik shopify wanneer Shopify de voorraad bijhoudt, of laat het leeg wanneer de voorraad niet wordt bijgehouden. |
| Inventory quantity | Het voorraadaantal. In de product-CSV van Shopify is dit voor een winkel met één locatie. |
| Continue selling when out of stock | Gebruik deny om de verkoop bij nul te stoppen of continue om door te verkopen. |
| Fulfillment service | De dienst die de variant verwerkt. Producten die je zelf verstuurt gebruiken meestal manual. |
| Requires shipping | true voor een fysiek artikel en false voor een digitaal artikel of een artikel dat niet wordt verzonden. |
| Charge tax | true wanneer de variant belast wordt en false wanneer dat niet zo is. |
| Weight value (grams) | Het verzendgewicht in grammen, bijvoorbeeld 250. |
| Weight unit for display | De eenheid die in de winkel wordt getoond: g, kg, lb of oz. |
| Cost per item | Wat het artikel jou kost. Klanten zien dit niet. |
Simple CSV leest, matcht, exporteert en werkt alleen de eerste barcode van elke variant bij. Een tweede barcode kan geen product matchen. Een gekoppelde barcodekolom werkt de eerste barcode bij en laat de andere barcodes staan.
Shopify weigert een native CSV die zowel de huidige kolom Barcodes als de oudere kolom Barcode bevat. Houd de kop aan van het sjabloon of de export waarmee je bent begonnen.
Optiekolommen hangen van elkaar af. Als je een SKU, gewicht of een ander variantveld bijwerkt via de importer van Shopify, houd dan de kolommen met de optienaam en optiewaarde die de variant identificeren. Als je die kolommen weglaat, kunnen de bestaande varianten worden vervangen door één nieuwe standaardvariant.
Het veranderen van een optiewaarde kan ook het oude variant-ID verwijderen en een nieuw ID aanmaken. Dat kan apps of koppelingen breken die het oude ID hebben opgeslagen. Test wijzigingen aan opties eerst met een klein bestand.
De product-CSV van Shopify stelt alleen voorraad in voor een winkel met één locatie. Gebruik voor meerdere locaties de aparte voorraad-CSV van Shopify. Simple CSV pakt het anders aan: elke handmatige import werkt één Shopify-locatie bij die je tijdens de installatie kiest. Deze locatiekeuze is beschikbaar op Free, Pro en Scale. Een Pro- of Scale-automatisering werkt ook de gekozen locatie bij. Zo kunnen aparte automatiseringen verschillende locaties bijwerken, elk volgens hun eigen schema.
Hoe meerdere varianten één product delen
Herhaal dezelfde handle op elke variantrij. Zet de gedeelde productgegevens op de eerste rij en laat die gegevens leeg op de overige variantrijen.
URL handle,Title,Option1 name,Option1 value,SKU,Price
classic-tee,Classic Tee,Size,Small,TEE-S,29.99
classic-tee,,Size,Medium,TEE-M,29.99
classic-tee,,Size,Large,TEE-L,29.99Dit maakt één product met drie maten. Als elke rij een andere handle krijgt, ontstaan er drie aparte producten.
Afbeeldingskolommen en extra afbeeldingsrijen
Product-CSV-bestanden bevatten afbeeldings-URL’s, niet de afbeeldingsbestanden zelf.
| Kolom | Wat je invult |
|---|---|
| Product image URL | Een openbare link naar de productafbeelding. |
| Image position | Een getal dat de volgorde van de afbeeldingen bepaalt, beginnend bij 1. |
| Image alt text | Een korte beschrijving van de afbeelding voor klanten die een schermlezer gebruiken. |
| Variant image URL | De afbeelding die wordt getoond wanneer een klant die variant selecteert. |
Voor Simple CSV moet elke afbeeldings-URL beginnen met https:// of //. Een relatief pad zoals /images/photo.jpg wordt overgeslagen, en het product wordt zonder die afbeelding geïmporteerd. De URL moet zonder inloggen te openen zijn en naar een afbeelding wijzen, niet naar een webpagina.
Voeg extra productafbeeldingen toe op nieuwe rijen. Herhaal de handle, laat de productvelden leeg en vul de afbeeldingskolommen in.
URL handle,Title,Product image URL,Image position
canvas-bag,Canvas Bag,https://example.com/bag-front.jpg,1
canvas-bag,,https://example.com/bag-side.jpg,2Oudere Shopify-koppen en hun equivalenten
Shopify accepteert nog steeds de oudere product-CSV-koppen. Gebruikt je export het oudere formaat, houd die koppen dan in het hele bestand aan.
| Huidige kop | Oudere kop |
|---|---|
| URL handle | Handle |
| Description | Body (HTML) |
| Product category | Product Category |
| Published on online store | Published |
| Option1 name / Option1 value | Option1 Name / Option1 Value |
| Option2 name / Option2 value | Option2 Name / Option2 Value |
| Option3 name / Option3 value | Option3 Name / Option3 Value |
| SKU | Variant SKU |
| Price | Variant Price |
| Compare-at price | Variant Compare At Price |
| Barcodes | Variant Barcode of Barcode |
| Inventory tracker | Variant Inventory Tracker |
| Inventory quantity | Variant Inventory Qty |
| Continue selling when out of stock | Variant Inventory Policy |
| Fulfillment service | Variant Fulfillment Service |
| Requires shipping | Variant Requires Shipping |
| Charge tax | Variant Taxable |
| Weight value (grams) | Variant Grams |
| Weight unit for display | Variant Weight Unit |
| Product image URL | Image Src |
| Image position | Image Position |
| Image alt text | Image Alt Text |
| Variant image URL | Variant Image |
| SEO title | SEO Title |
| SEO description | SEO Description |
Nieuwe producten importeren als Active, Draft of Unlisted
Wanneer je nieuwe producten toevoegt met Simple CSV, toont de voorbeeldpagina de status die de import gaat schrijven. Je kunt de gekoppelde Status-waarde behouden of Override status for all new products gebruiken om Active, Draft of Unlisted te kiezen voor elk nieuw aangemaakt product.
Unlisted producten zijn te openen en te kopen via een directe link, maar ze blijven buiten de zoekfunctie, collecties en aanbevelingen van Shopify.
De override vervangt zowel de gekoppelde Status-kolom als de standaardstatus. Maak de override leeg met Use mapped status (default: Active) om de waarde uit het bestand weer te gebruiken. Archived wordt niet aangeboden als override.
Deze instelling verandert geen bestaande producten tijdens een update-import. De instelling is beschikbaar op elk plan. Een Pro- of Scale-automatisering slaat de keuze op en gebruikt deze telkens wanneer het geplande bestand wordt verwerkt.
Lege cellen zijn niet hetzelfde als ontbrekende kolommen
Dit verschil is belangrijk wanneer je de optie van Shopify selecteert om producten met dezelfde handle te overschrijven.
- Een lege cel in een opgenomen kolom kan de bestaande waarde wissen. Een lege Vendor-cel kan bijvoorbeeld de opgeslagen leverancier verwijderen.
- Een kolom die niet in het bestand staat, laat dat bestaande veld in de meeste gevallen ongewijzigd.
- Een kolom die afhangt van ontbrekende optiegegevens kan toch variantinformatie verwijderen.
Exporteer de producten die je wilt wijzigen, bewaar een back-up en test een paar rijen voordat je een grote update doet. Shopify heeft geen knop om een product-CSV-import in één klik ongedaan te maken.
Regels voor spreadsheets en bestanden
Sla het bestand op als CSV met UTF-8-codering, zodat namen en beschrijvingen hun accenten en andere speciale tekens behouden. De limiet voor een product-CSV-bestand van Shopify is 15 MB. Splits een groter bestand dus in kleinere imports.
Let op deze veranderingen door spreadsheets:
- Excel of Google Sheets kan een lange barcode zoals
8712345678901veranderen in8.71235E+12. Stel de barcodekolom in als Text (tekst) voordat je waarden plakt. - Een komma in een beschrijving of taglijst moet in een cel tussen aanhalingstekens blijven. Spreadsheet-apps regelen dit wanneer je exporteert als CSV.
- Prijzen moeten getallen bevatten zoals
29.99, geen valutasymbolen zoals$29.99. - Kolomnamen zijn hoofdlettergevoelig in de eigen importer van Shopify. Kopieer ze uit het sjabloon in plaats van ze opnieuw te typen.
Een Shopify CSV-sjabloon gebruiken
Het veiligste startpunt is een export van producten uit je eigen winkel. Die gebruikt de kolomnamen die Shopify op dit moment aan je winkel geeft en laat zien hoe je bestaande varianten zijn opgebouwd.
Je kunt ook het officiële product-CSV-sjabloon van Shopify downloaden. Verwijder de voorbeeldproducten voordat je je eigen producten toevoegt.
Simple CSV kan een leeg sjabloon maken, een sjabloon met een voorbeeldrij of een bestand op basis van je huidige winkelgegevens. Open Simple CSV vanuit Shopify Admin om er een te kiezen.
Meer hulp
Mislukt je import nog steeds, bekijk dan CSV-importfouten oplossen.
Voor de volledige native importworkflow en meer voorbeelden lees je de complete Shopify CSV-importgids.
Werkt je leverancier een feed regelmatig bij, lees dan onze gids voor leverancierssynchronisatie met Shopify. Geplande URL-imports zijn beschikbaar op Pro en Scale.