Producten importeren met een CSV-bestand

Producten importeren in je Shopify-winkel met een CSV-bestand (comma-separated values) is handig als je van een ander platform naar Shopify overstapt of als je veel wijzigingen in je producten of voorraad wilt aanbrengen.

Wanneer je producten importeert, worden de gegevens van het CSV-bestand omgezet in producten en kun je selecteren of je je nieuwe producten wilt publiceren op alle verkoopkanalen of alleen in je webshop.

Op deze pagina

Voordat je begint

Voordat je producten importeert met een CSV-bestand, moet je de volgende onderwerpen hebben gelezen:

Productimports die met een CSV-bestand zijn gestart, kunnen niet worden geannuleerd nadat ze zijn begonnen. Je kunt ook geen geschiedenis van eerdere imports bekijken. Controleer het activiteitenlogboek van je winkel om recente wijzigingen door een import te bekijken.

Imports testen met een dev store

Als je een Shopify-partner bent en een grootschalige import voor een merchant uitvoert, test dan eerst een kleine subset van de wijzigingen met een dev store voordat je de daadwerkelijke importopdracht uitvoert.

Aandachtspunten voor het overschrijven van je productgegevens met een CSV-importbestand

Wanneer je een CSV-bestand importeert, kun je de optie Producten met overeenkomende handles overschrijven selecteren. Als je deze optie selecteert en de handle in het CSV-importbestand overeenkomt met een bestaande handle in je productlijst, worden de waarden in het CSV-bestand over de waarden in de overeenkomende kolommen in de bestaande productlijst heengeschreven. Als de overschrijfoptie niet is geselecteerd, worden de producten die overeenkomen met een bestaande handle genegeerd tijdens de CSV-import.

Als een niet-vereiste kolom in het CSV-importbestand leeg is, wordt de overeenkomstige waarde in de productlijst ook als leeg overschreven.
- Als bijvoorbeeld de Vendor waarde in je bestaande productlijst John's Apparel is, maar de Vendor kolom leeg is in het CSV-bestand dat je importeert, wordt John's Apparel overschreven als leeg.
Als een niet-vereiste kolom niet is opgenomen in het CSV-importbestand, maar wel in de bestaande productlijst, blijft de waarde in de productlijst hetzelfde.
- Als bijvoorbeeld de Variant image URL kolom is opgenomen in de bestaande productlijst, maar die kolom niet is opgenomen in het CSV-importbestand, blijft de waarde in de productlijst hetzelfde.
Als een niet-vereiste kolom is opgenomen in het CSV-importbestand die afhankelijk is van andere kolomgegevens die niet in het bestand zijn opgenomen, worden bestaande gegevens verwijderd.
- Als bijvoorbeeld de kolom SKU is opgenomen in het CSV-importbestand, maar de kolommen Option1 value en Option1 name niet, wordt de keuzevariant van het product verwijderd.
CSV-bestanden kunnen niet worden gebruikt om producten in bulk te verwijderen. Als je producten in bulk wilt verwijderen, kun je bulkacties gebruiken in de sectie Producten van je beheercentrum.
CSV-bestanden kunnen niet worden gebruikt om de productbeschikbaarheid in andere verkoopkanalen in bulk bij te werken. Lees meer over het instellen van de productbeschikbaarheid in andere verkoopkanalen.

Producten importeren vanuit een andere winkel

Als je een CSV-bestand hebt dat is geëxporteerd vanuit een andere winkel of afkomstig is van een andere bron, controleer dan of het overeenkomt met de indeling voor CSV-bestanden. Als de indeling niet overeenkomt of als er kopteksten ontbreken, mislukt de import.

Je CSV-productbestand mag niet groter zijn dan 15 MB. Als je een foutmelding krijgt wanneer je een nieuw CSV-bestand probeert te uploaden, of als de upload een time-out heeft, splits je het CSV-bestand op in meerdere kleinere bestanden en upload je elk bestand afzonderlijk.

Stappen:

Ga vanuit het Shopify-beheercentrum naar Producten.
Klik op Importeren.
Klik op Bestand toevoegen en selecteer het CSV-bestand dat je wilt importeren.
Optioneel: Als je nieuwe producten alleen in je webshop wilt publiceren en niet op al je verkoopkanalen, deselecteer je Nieuwe producten op alle verkoopkanalen publiceren.
Optioneel: Selecteer Producten met overeenkomende handles overschrijven als je de URL's wilt wijzigen door de waarden voor de bestaande handles te overschrijven. De bestaande waarden worden vervangen voor alle kolommen die in het CSV-bestand zijn opgenomen.
Klik op Uploaden en doorgaan.
Controleer de gegevens over de import en klik vervolgens op Producten importeren.

Nadat je CSV-bestand is geüpload, ontvang je een bevestigingsmail van Shopify op het e-mailaccount dat je hebt gebruikt om je Shopify-winkel in te stellen. Lees enkele oplossingen voor veelvoorkomende problemen.

Producten importeren met een CSV-bestand

Als je wijzigingen in je producten wilt aanbrengen met een CSV-bestand, moet je eerst je producten exporteren. Je kunt je CSV-bestand wijzigen in een spreadsheetprogramma, zoals Google Sheets, en vervolgens je bijgewerkte CSV importeren in het Shopify-beheercentrum.

Stappen

Ga vanuit het Shopify-beheercentrum naar Producten.
Klik op Importeren.
Klik op Bestand toevoegen en selecteer het CSV-bestand dat je wilt importeren.
Optioneel: Als je nieuwe producten alleen in je webshop wilt publiceren en niet op al je verkoopkanalen, deselecteer je Nieuwe producten op alle verkoopkanalen publiceren.
Optioneel: Selecteer Producten met overeenkomende handles overschrijven als je de URL's wilt wijzigen door de waarden voor de bestaande handles te overschrijven. De bestaande waarden worden vervangen voor alle kolommen die in het CSV-bestand zijn opgenomen.
Klik op Uploaden en doorgaan.
Controleer de gegevens over de import en klik vervolgens op Producten importeren.

Probleemoplossing voor CSV-imports

Als je problemen ondervindt bij het importeren van een CSV-bestand, bekijk dan de volgende informatie over probleemoplossing.

Onverwachte tekens of symbolen in geïmporteerde content

Als je onverwachte tekens of symbolen opmerkt in je productbeschrijvingen, titels of andere content na het importeren van een CSV-bestand, dan is het bestand mogelijk niet opgeslagen met UTF-8-codering (Unicode Transformation Format - 8-bit).

UTF-8-codering is vereist om te voorkomen dat er onverwachte tekens in je content verschijnen. Standaard slaat Google Sheets bestanden automatisch op met UTF-8-codering. Bij andere spreadsheetsoftware is mogelijk een extra stap nodig om op te slaan met UTF-8-codering.

De betreffende artikelen handmatig herstellen

Loop elk betreffend product na en wijzig of verwijder de tekens handmatig. Dit werkt het beste als het maar om een paar artikelen gaat.

Een oudere versie importeren

Als je een eerdere versie van het CSV-bestand hebt die met de juiste codering is opgeslagen, importeer dan die versie.

Opnieuw opslaan met de juiste codering

Open het onjuist gecodeerde CSV-bestand en sla het opnieuw op met UTF-8-codering. Het proces verschilt per besturingssysteem en spreadsheetprogramma. Raadpleeg CSV-bestanden voor instructies.

Netwerkfout: Unexpected token in JSON at position 0

Als je de foutmelding Network error: Unexpected token < in JSON at position 0 ontvangt, komen de CSV-kolomtitels niet exact overeen met de vereiste kopteksten van de CSV-template. Kolomkopteksten zijn hoofdlettergevoelig.

Kolomkopteksten controleren en corrigeren

Raadpleeg de handleiding voor CSV-opmaak voor de juiste CSV-opmaak.
Vergelijk je CSV-kolomkoppen met het voorbeeldbestand.
Controleer of de kopteksten van je CSV-bestand exact overeenkomen met het voorbeeldbestand, inclusief hoofdlettergevoeligheid. Gebruik bijvoorbeeld Handle in plaats van handle.
Corrigeer de kopteksten van je CSV-bestand zodat ze overeenkomen met de kopteksten van het voorbeeldbestand. Je kunt een kopie van het voorbeeldbestand downloaden vanuit de handleiding voor CSV-opmaak.

Fout met ongeldige aanhalingstekens

Een fout met ongeldige aanhalingstekens treedt op als er komma's en aanhalingstekens in je CSV-bestand staan die niet met UTF-8 zijn gecodeerd.

Om een product-CSV correct te importeren, moeten alle aanhalingstekens en apostroffen UTF-8-gecodeerd zijn en op de juiste positie staan. Niet-UTF-8-gecodeerde aanhalingstekens worden bijvoorbeeld gekruld weergegeven: “ ”, en UTF-8-gecodeerde aanhalingstekens zijn recht: " ".

Bestand opslaan met UTF-8-codering

Sla je oorspronkelijke bestand vóór het importeren op met UTF-8-codering.

Import mislukt met foutmelding 'Line is invalid (No details)'

Als je een foutmelding krijgt die aangeeft dat specifieke regels ongeldig zijn zonder verdere details, dan wordt het probleem mogelijk veroorzaakt door conflicten met bestaande productvariantopties. Dit gebeurt wanneer je een optiewaarde van de ene optiepositie naar de andere probeert te wijzigen.

Oorzaak van dit probleem

De CSV-import mislukt wanneer een bestand een bestaande optiewaarde probeert toe te wijzen aan een nieuwe optiepositie, waardoor een conflict ontstaat omdat keuzevarianten uniek moeten zijn. Als je bijvoorbeeld probeert Size van Optie 1 naar Optie 2 te verplaatsen en Type als de nieuwe Optie 1 toevoegt, valideert de database op dubbele namen voordat nieuwe waarden worden geïmporteerd en mislukt het proces.

Het conflict oplossen

Gebruik een tijdelijke optienaam tijdens de import en werk deze daarna bij:

Gebruik in je CSV-bestand een alternatieve tijdelijke naam voor de optie die het conflict veroorzaakt. Gebruik bijvoorbeeld Size. (met een punt) in plaats van Size.
Importeer het CSV-bestand met de tijdelijke optienaam.
Nadat de import is voltooid, maak je een nieuw CSV-bestand aan waarin je de tijdelijke optienaam wijzigt in de gewenste naam.
Importeer het bijgewerkte CSV-bestand om de definitieve optienaam toe te passen.