WooCommerce CSV import producten: fouten, ontbrekende afbeeldingen en wanneer een gesprek handiger is
Een WooCommerce CSV-import van producten mislukt meestal om vier redenen: het verkeerde bestandsformaat, kolommen die niet bij het schema van WooCommerce passen, dubbele SKU’s en adressen van afbeeldingen die de server niet kan downloaden. Sla het bestand eerst op in UTF-8 en vergelijk het met een export van een paar producten uit je webshop. Controleer de afbeeldingen door hun adressen in een browser te openen.
Auteur: Het TellMyShop-team. Een gids voor eigenaren van WordPress-websites en WooCommerce-winkels: de oorzaak, de oplossing met de hand en hetzelfde werk in een gesprek met de chat.
Laatst bijgewerkt: · 7 min lezen
De meest voorkomende importfouten en wat ze betekenen
De ingebouwde importeur vind je onder Producten → Alle producten, met de knop Importeren bovenaan de lijst. Na de import toont hij een overzicht: hoeveel producten hij heeft aangemaakt, bijgewerkt en overgeslagen, en welke een fout hadden. De documentatie over de CSV-importeur en -exporteur beschrijft de regels voor het bestand, en het importschema op GitHub heeft de volledige lijst met kolommen.
| Wat je ziet | Meest voorkomende oorzaak | Wat je doet |
|---|---|---|
| Letters met accenten veranderd in wartaal | het bestand is niet in UTF-8 | opslaan als CSV UTF-8 en opnieuw importeren |
| Rijen overgeslagen omdat het product al bestaat | de SKU of ID staat al in de webshop | bestaande producten bijwerken aanvinken, of de SKU wijzigen |
| Lege namen, prijzen of beschrijvingen | kolommen zijn niet gekoppeld in de stap voor het koppelen | de kolommen met de hand toewijzen in de stap voor het koppelen |
| Prijs van 0 of een vreemd bedrag | de spreadsheet heeft de getalnotatie gewijzigd | de prijsnotatie vergelijken met het voorbeeldbestand en die aanhouden |
| Producten zonder categorie of met nieuwe, vreemde categorieën | een typfout in de categorienaam of een verkeerd geschreven subcategorie | de categorienamen en de notatie voor de hiërarchie in het schema controleren |
| Import stopt halverwege | een tijd- of geheugenlimiet op de server | het bestand in kleinere delen splitsen, je hostingpartij naar limieten vragen |
| Variaties zonder prijs of attributen | rijen van variaties verwijzen niet naar het hoofdproduct | de kolom voor het hoofdproduct en de attributen in rijen van variaties controleren |
De WooCommerce-documentatie waarschuwt ook voor spreadsheets die ongemerkt opmaak en codering wijzigen. Open een bestand dat je in een spreadsheet hebt bewerkt voor het importeren in een gewone teksteditor en kijk of de kolommen en tekens er hetzelfde uitzien als in de export.
Waarom afbeeldingen niet worden geïmporteerd
Dit is de meest gehoorde klacht na een import: de producten zijn er, de afbeeldingen niet. Tijdens de import downloadt WooCommerce elke afbeelding van het adres in het bestand en voegt hij die toe aan de mediabibliotheek. Mislukt het downloaden, dan wordt het product zonder afbeelding aangemaakt. Controleer op volgorde:
- Het adres opent de afbeelding zelf. Plak het in een privévenster van de browser. Je moet een afbeelding zien, geen inlogpagina, een voorbeeld in een clouddrive of een bestandsdownload.
- Het adres is openbaar. Afbeeldingen uit het ingelogde deel van een groothandel of uit een privémap worden niet gedownload.
- De kolom met afbeeldingen is goed geschreven. Meerdere afbeeldingen voor één product staan in één kolom, gescheiden zoals het schema laat zien. De eerste afbeelding wordt de hoofdafbeelding.
- De server van de leverancier blokkeert geen downloads. Sommige servers weigeren massale downloads vanaf een andere site. De enige oplossing is de afbeeldingen zelf downloaden en in de mediabibliotheek uploaden, of het de leverancier vragen.
- De afbeeldingen zijn niet te groot. Heel grote bestanden kunnen de tijd- of geheugenlimiet van de server overschrijden. Een kleinere batch producten per import lost het vaak op.
- Een bestandsnaam in plaats van een adres. Staan de afbeeldingen al in de mediabibliotheek, dan kun je in het bestand hun namen opgeven in plaats van volledige adressen. De maand waarin de bestanden naar de bibliotheek zijn geüpload, kan dan uitmaken. De handleiding van WebToffee over fouten bij het importeren van afbeeldingen noemt typische redenen waarom downloads mislukken.
Ontbreken afbeeldingen na een import maar bij een deel van de producten, zet die producten dan op een lijst en vergelijk hun afbeeldingsadressen met de adressen die wel werkten. Het verschil wijst meestal direct naar de oorzaak.
Zo bereid je het bestand voor zodat de import de eerste keer lukt
Een bestand dat is gebouwd op een export uit je eigen webshop geeft de minste fouten:
- Voeg met de hand twee of drie producten toe, waaronder één met variaties, en exporteer ze naar CSV.
- Plak de gegevens van de leverancier in dezelfde kolommen zonder de koppen te wijzigen.
- Importeer eerst vijf rijen. Controleer de naam, prijs, categorie, afbeeldingen en variaties in de webshop.
- Importeer pas daarna de rest, in delen van een paar honderd rijen als de server vaak traag is.
- Je kunt nieuwe producten als concept importeren, zodat je ze kunt controleren voordat je ze publiceert.
De handleiding van WP Engine over producten importeren uit CSV noemt de ingebouwde importeur een goede keuze voor kleine en middelgrote webshops met eenvoudige gegevens. Voor complexe bestanden van leveranciers en regelmatige updates is een plugin voor geplande imports vaak beter.
CSV of een gesprek met de chat: wanneer gebruik je wat
De TellMyShop-plugin voor WordPress en WooCommerce vervangt geen import van duizenden producten en leest het foutrapport van de importeur niet. Hij helpt in twee situaties: als het maar om een handvol nieuwe producten gaat, en als je moet uitzoeken wat er na een import misging.
| Situatie | Betere keuze | Waarom |
|---|---|---|
| Duizenden producten uit een bestand van een groothandel | CSV-import of een importplugin | één bestand, één proces, elke week te herhalen |
| Dagelijkse updates van prijzen en voorraad van een leverancier | een plugin voor geplande imports | draait vanzelf, geen gesprek nodig |
| Een handvol nieuwe producten uit een e-mail van een leverancier | een gesprek met de chat | geen bestand te bouwen, beschrijving meteen geschreven |
| Controle na een import: producten zonder afbeeldingen, beschrijving, categorie | een gesprek met de chat | de lijst met gaten in één antwoord |
| Verbeteringen na een import: beschrijvingen, categorieën, afbeeldingen | een gesprek met de chat | batches met een voorbeeld in plaats van opnieuw importeren |
Na de import: de gaten in één lijst
De gratis versie TellMyShop Free leest producten en hun volledige gegevens, dus je chat (Claude of ChatGPT) vindt producten zonder hoofdafbeelding, zonder beschrijving, zonder categorie of met een prijs van nul. In TellMyShop Pro kan hij die gaten vullen: afbeeldingen toevoegen vanaf openbare adressen, categorieën toewijzen en beschrijvingen schrijven, altijd met een voorbeeld. Prijzen en voorraad slaat hij pas op als de schakelaar Verkoop in het pluginpaneel aanstaat. Een voorbeeldgesprek, met voorbeeldgetallen:
Jij: Gisteren heb ik 400 producten van een nieuwe leverancier geïmporteerd. Kijk wat er ontbreekt.
Je chat: Van de 400 nieuwe producten hebben er 37 geen hoofdafbeelding, 12 geen categorie, en 5 een prijs van € 0. Alle 37 zonder afbeelding horen bij één merk, Trail. Controleer hun afbeeldingsadressen in het bestand en open er een in een privévenster: zie je een inlogpagina in plaats van de afbeelding, dan is het downloaden geblokkeerd.
Jij: Je hebt gelijk, het is een inlogpagina. Ik vraag de afbeeldingen op bij de leverancier. Wijs de categorieën toe op naam, zoals bij de andere producten.
Je chat: Voorbeeld voor 12 producten:
Ik sla het op na jouw ‘ja’. De prijzen van nul vragen de schakelaar Verkoop.
Status van de kaart: wacht op jouw “ja”Trail-reismok 450 ml
oude versie: geen categorie
nieuwe versie: Mokken en thermosflessen
De chat maakt nieuwe producten uit een lijst een paar tegelijk aan, tot 10 in één batch, als concepten die niet zichtbaar zijn in de webshop. Hoe het toevoegen van producten uit een e-mail van een leverancier werkt, laten we zien in het stuk over een product toevoegen in WooCommerce. Elke wijziging komt in de wijzigingsgeschiedenis en kan ongedaan worden gemaakt.
De gratis versie probeer je via de pagina van de gratis versie. Details over de plugin staan op de pagina TellMyShop voor WordPress en WooCommerce, prijzen op de pagina prijzen. Verschijnen producten na een import niet in de webshop, loop dan de handleiding product niet zichtbaar in WooCommerce door, en gaat het probleem over variaties, de checklist voor productvariaties.
Vragen en antwoorden
Waarom zijn letters met accenten na een CSV-import vervangen door rare tekens?
Het bestand is niet in UTF-8-codering opgeslagen. Spreadsheets slaan CSV vaak in een andere codering op. Sla het bestand opnieuw op als CSV UTF-8 en importeer het nog een keer met de optie om bestaande producten bij te werken.
Waarom worden afbeeldingen uit het CSV-bestand niet geïmporteerd?
Meestal opent het adres van de afbeelding niet openbaar, blokkeert de server van de leverancier downloads, of zijn de adressen in de kolom met afbeeldingen verkeerd gescheiden. Open een paar adressen uit het bestand in een privévenster van de browser. Zie je niet de afbeelding zelf, dan downloadt WooCommerce hem ook niet.
Hoe werk ik prijzen van bestaande producten bij via CSV zonder dubbele producten?
Vink in de eerste stap van de import de optie aan om bestaande producten bij te werken. WooCommerce koppelt rijen aan producten op ID of SKU. Zonder die optie eindigt een rij met een bestaande SKU in een fout of wordt hij overgeslagen.
Vervangt de chat een import van duizenden producten?
Nee. Voor duizenden artikelen uit een bestand van een leverancier is een CSV-import of een plugin voor geplande imports beter. De TellMyShop-plugin helpt bij een handvol nieuwe producten uit een e-mail of lijst, en bij het controleren wat er na een import moet worden verbeterd.
Waar vind ik een voorbeeld-CSV-bestand voor WooCommerce?
WooCommerce levert een voorbeeld-CSV-bestand, waarnaar de documentatie van de importeur linkt. Het eenvoudigste sjabloon is ook een export van een paar van je eigen producten uit de backoffice, want dat bestand heeft al de juiste kolomnamen.
WordPress is een handelsmerk van de WordPress Foundation. WooCommerce is een handelsmerk van Automattic Inc. Claude is een handelsmerk van Anthropic PBC. ChatGPT en OpenAI zijn handelsmerken van OpenAI. TellMyShop is niet gelieerd aan deze bedrijven.