PRAKTISCHE KENNISBANK

WooCommerce producten zonder afbeelding na import: zo zoek je de oorzaak

Productfoto’s ontbreken na een WooCommerce CSV-import? Controleer bronlinks, redirects, bestandsformaten, beveiliging en importlogs.

Waarom missen sommige geïmporteerde WooCommerce-producten hun foto?

Een CSV- of XML-import kan productinformatie correct toevoegen terwijl afbeeldingen ontbreken. Soms zijn alleen een paar producten getroffen, soms de hele batch. De oorzaak zit vaak in de afbeeldingslink of het ophalen ervan, maar het kan ook een fout in de mapping, een blokkade door de leverancier of een probleem in de WordPress-mediabibliotheek zijn.

1. Bekijk de ruwe afbeeldingskolom

Open de bronfeed en controleer hoe de afbeeldingen zijn aangeleverd. Zijn het volledige HTTPS-URL’s, bestandsnamen, relatieve paden of meerdere links in één veld? Bij WooCommerce moeten de waarden op de juiste kolom worden gekoppeld. Een veld vol bestandsnamen zonder basis-URL is niet hetzelfde als een direct bereikbaar afbeeldingsadres.

2. Test één URL buiten de import

Open de afbeeldingslink rechtstreeks in een privébrowser. Je verwacht een afbeeldingsbestand, geen inlogpagina, foutmelding of HTML-overzicht. Controleer of de host bereikbaar is, of HTTPS werkt en of de link niet alleen tijdelijk geldig is. Sommige leveranciers gebruiken downloadadressen die na enige tijd verlopen.

3. Controleer of de leverancier externe downloads blokkeert

Een afbeelding kan in jouw browser wel laden, maar door de server van de webshop worden geweigerd, bijvoorbeeld door hotlinkbescherming of een vereiste autorisatie. Kijk in de importlogs naar HTTP-statuscodes, download-timeouts of foutmeldingen over bestandsformaten. Vermijd het om beveiliging blind uit te schakelen; vraag zo nodig bij de leverancier om een officiële mediafeed.

4. Controleer bestandstype en bestandsformaat

Niet ieder afbeeldingsformaat wordt op iedere hostingomgeving op dezelfde manier verwerkt. Controleer of het werkelijk een JPEG, PNG, WEBP of een ander geschikt formaat is. Ook beschadigde of uitzonderlijk grote bestanden kunnen problemen veroorzaken. Een thumbnail kan ontbreken terwijl de originele media wel aanwezig is.

5. Controleer de mediabibliotheek en productkoppeling

Staat de afbeelding in WordPress maar niet bij het product? Dan is de koppeling mogelijk niet goed aangemaakt. Staat het bestand nergens, dan is het downloaden of verwerken vermoedelijk mislukt. De twee gevallen vereisen verschillende oplossingen. Kijk ook of de afbeelding als uitgelichte afbeelding of alleen als galerijafbeelding is ingevoerd.

6. Controleer bestaande productgegevens bij een update

Een periodieke import mag niet blind een werkende productfoto verwijderen wanneer de leverancier tijdelijk een leeg veld teruggeeft. Bepaal of ontbrekende afbeeldingsgegevens de bestaande afbeelding moeten behouden, een nieuwe poging moeten veroorzaken of het product tijdelijk niet gepubliceerd mag worden.

7. Publiceer een testbatch pas na visuele controle

Selecteer verschillende soorten afbeeldingen: een normale hoofdafbeelding, extra galerijbeelden, een product met lange naam en een product waarvan de externe link opnieuw wordt opgehaald. Controleer productpagina én productoverzicht op mobiel en desktop. Pas daarna schaal je op.

Loopt je import steeds tegen ontbrekende afbeeldingen aan? Bekijk productfeeds herstellen of beschrijf het probleem vrijblijvend. Geef daarbij een voorbeeld-EAN en één afbeeldingslink, zonder inloggegevens.

Let op: maak voor technische wijzigingen een back-up van bestanden en database en test ingrijpende aanpassingen bij voorkeur eerst op een testomgeving. De juiste oplossing verschilt per WordPress-installatie.