Overslaan naar inhoud
Q&A

Productfoto's bulk importeren in Odoo

1.000 producten zonder dat u elke foto handmatig hoeft te uploaden.

Terug naar alle Q&A
12 mei 2026 in
Productfoto's bulk importeren in Odoo
DAADit Group, Nick

De webshop staat bijna live, het assortiment zit in Odoo, en dan ligt daar nog die map met 800 productfoto's. Stuk voor stuk uploaden? Dat kost u dagen en minstens één RSI-pols. Gelukkig kan het in bulk — op twee manieren, afhankelijk van waar uw foto's nu staan.

Productfoto's bulk importeren in Odoo

Methode 1: CSV-import met image_1920

  1. Open de productlijst en exporteer naar CSV met in elk geval id (externe ID) en een kolom image_1920.
  2. Vul de kolom image_1920 per product met de volledige URL van de afbeelding (bijvoorbeeld vanaf uw oude webshop of een publieke map) óf met de base64-gecodeerde inhoud van het bestand.
  3. Importeer het bestand terug via Favorieten → Records importeren. Odoo haalt de URL's op en slaat de afbeeldingen bij het juiste product op.

Deze route werkt prima als uw foto's al ergens online staan. Een fietsenwinkel die van een oude webshop overstapt, kan zo de bestaande afbeeldings-URL's één-op-één hergebruiken.

Methode 2: script via XML-RPC

Staan de foto's alleen lokaal, bijvoorbeeld als 8719325001234.jpg per artikelnummer? Dan is een klein Python-script via XML-RPC (of de nieuwere JSON-RPC API) sneller: het zoekt per default_code (SKU) het product op, leest het bestand in, codeert het naar base64 en schrijft het naar image_1920. Draai zo'n script altijd eerst op een testdatabase of staging-omgeving — een typfout in de bestandsnaamlogica koppelt anders vrolijk verkeerde foto's aan honderden producten.

Let op bij Odoo 20: de "db"-service van XML-RPC en JSON-RPC is verwijderd, en de services "common" en "object" staan gepland voor verwijdering in Odoo 22. Gebruik voor nieuwe scripts de External JSON-2 API. De externe API is alleen beschikbaar op een Custom-abonnement.

Eerst optimaliseren, dan importeren

  • Maximaal 1920 pixels breed — groter geeft geen zichtbaar kwaliteitsvoordeel, Odoo schaalt toch terug.
  • Onder 2 MB per bestand; zware afbeeldingen vertragen uw webshop merkbaar.
  • Batch-comprimeer vooraf met een tool als TinyPNG of Squoosh.
  • Gebruik logische bestandsnamen (SKU of EAN), dat maakt de koppeling foutloos.

Varianten en extra foto's

De kolom image_1920 vult de hoofdafbeelding van het product. Heeft u varianten, bijvoorbeeld één T-shirt in vijf kleuren, dan wilt u vaak per kleur een eigen foto. Importeer die dan niet op het product, maar op het model Productvariant, met de kolom voor de variantafbeelding (image_variant_1920). Koppel ook hier op een vaste sleutel: de externe ID van de variant of de interne referentie per variant.

Voor extra foto's in de webshop, zoals een detailopname of een sfeerbeeld, gebruikt Odoo aparte mediarecords die aan het product hangen. Die kunt u ook importeren, maar het is een tweede bestand naast uw productimport. Controleer in uw eigen omgeving welke velden beschikbaar zijn voordat u het bestand opbouwt: exporteer eerst één product met extra foto's en gebruik dat als sjabloon.

Uit de praktijk: waar het misgaat

In de supportvragen die wij krijgen, komen steeds dezelfde oorzaken terug.

  • Links die geen afbeelding zijn. Een deellink uit een cloudmap opent vaak een webpagina met een voorbeeld, niet het bestand zelf. Odoo krijgt dan geen afbeelding binnen en de import faalt of blijft leeg. Test één link in een privévenster: ziet u alleen de foto, dan is de link bruikbaar.
  • Ongelijke formaten. Een klant vroeg ons om afbeeldingen in het systeem uniform te maken, omdat staande, liggende en vierkante foto's door elkaar een onrustig beeld gaven. Spreek vooraf één verhouding af, bij voorkeur vierkant, met dezelfde achtergrond. Dat scheelt achteraf werk.
  • Ontbrekende rechten. Bij een groothandel kon een medewerker de webshopgegevens van een product niet aanpassen, omdat zijn gebruiker alleen leesrechten op producten had. Wie importeert, heeft schrijfrechten op producten nodig.
  • Te grote bestanden in één keer. Honderden URL's in één import duren lang en kunnen afbreken. Knip het bestand op in delen van een paar honderd regels.
  • Foto's staan erin, maar de klant ziet niets. Ook die melding kregen wij. Controleer dan eerst of het product gepubliceerd is op de website en verkocht mag worden. Een foto maakt een product niet zichtbaar.

Veelgestelde vragen

Overschrijft een nieuwe import de bestaande foto's?

Ja, een gevulde kolom image_1920 vervangt de huidige hoofdafbeelding. Wilt u bij sommige producten de oude foto houden, neem die rijen dan niet op in het importbestand.

Welk bestandsformaat werkt het best?

JPG voor gewone productfoto's, PNG als u een transparante achtergrond nodig heeft. Houd de bestandsnaam eenvoudig, zonder spaties of speciale tekens.

Kan ik later alle foto's in één keer vervangen?

Ja. Omdat u op externe ID of SKU koppelt, draait u dezelfde route gewoon opnieuw met de nieuwe bestanden. Maak vooraf wel een export als back-up.

Tot slot

Praktische tip: importeer eerst vijf producten als proef en controleer het resultaat in de webshop voordat u de volle lading laat gaan. Hulp nodig bij een productmigratie of webshoplancering in Odoo? Neem contact op met DAADit Group, wij hebben de scripts al klaarliggen.

De webshop is bijna live, de catalogus staat in Odoo, en dan is er die map met 800 productfoto's. Eén voor één uploaden? Dat kost u dagen en minstens één zere pols. Gelukkig kan het in bulk — op twee manieren, afhankelijk van waar uw foto's nu staan.

Productfoto's bulk importeren in Odoo

Methode 1: CSV-import met image_1920

  1. Open de productlijst en exporteer naar CSV met minimaal id (externe ID) en een kolom image_1920.
  2. Vul de kolom image_1920 per product met de volledige URL van de afbeelding (bijvoorbeeld uit uw oude webshop of een openbare map) of met de base64-gecodeerde inhoud van het bestand.
  3. Importeer het bestand terug via Favorieten → Records importeren. Odoo haalt de URL's op en slaat elke afbeelding op bij het juiste product.

Deze route werkt goed wanneer uw foto's al ergens online staan. Een fietsenwinkel die migreert vanuit een oude webshop kan de bestaande afbeeldings-URL's één-op-één hergebruiken.

Methode 2: een script via XML-RPC

Staan de foto's alleen lokaal, bijvoorbeeld als 8719325001234.jpg per artikelnummer? Dan is een klein Python-script via XML-RPC (of de nieuwere JSON-RPC API) sneller: het zoekt elk product op via default_code (SKU), leest het bestand in, codeert het naar base64 en schrijft het naar image_1920. Draai zo'n script altijd eerst tegen een testdatabase of stagingomgeving — één typefout in de bestandsnaamlogica plakt vrolijk de verkeerde foto's aan honderden producten.

Let op bij Odoo 20: de "db"-service van XML-RPC en JSON-RPC is verwijderd, en de services "common" en "object" staan gepland voor verwijdering in Odoo 22. Gebruik voor nieuwe scripts de External JSON-2 API. De externe API is alleen beschikbaar op een Custom-abonnement.

Optimise first, import second

  • Maximaal 1920 pixels breed — groter geeft geen zichtbare kwaliteitswinst, Odoo schaalt het toch terug.
  • Onder 2 MB per bestand; zware afbeeldingen vertragen uw webshop merkbaar.
  • Comprimeer vooraf in bulk met een tool als TinyPNG of Squoosh.
  • Gebruik logische bestandsnamen (SKU of EAN), zodat het matchen foutloos verloopt.

Variants and extra photos

The image_1920 column fills the product's main image. If you work with variants, for example one T-shirt in five colours, you usually want a separate photo per colour. In that case, do not import it on the product but on the Product Variant model, using the column for the variant image (image_variant_1920). Match on a fixed key here as well: the variant's external ID or an internal reference per variant.

For extra photos in the webshop, such as a close-up or a lifestyle shot, Odoo uses separate media records linked to the product. You can import those too, but it is a second file next to your product import. Check which fields are available in your own environment before you build the file: export one product with extra photos first and use that as a template.

From practice: where it goes wrong

The support requests we receive keep pointing to the same causes.

  • Links that are not images. A share link from a cloud folder often opens a web page with a preview, not the file itself. Odoo then receives no image and the import fails or stays empty. Test one link in a private window: if you see only the photo, the link is usable.
  • Inconsistent formats. A customer asked us to make the images in the system uniform, because portrait, landscape and square photos mixed together looked messy. Agree on one aspect ratio beforehand, preferably square, with the same background. That saves rework later.
  • Missing access rights. At a wholesaler, an employee could not change a product's webshop details because his user only had read access to products. Whoever runs the import needs write access to products.
  • Too many files at once. Hundreds of URLs in a single import take a long time and can break off. Split the file into batches of a few hundred lines.
  • The photos are there, but customers see nothing. We have had that report too. First check whether the product is published on the website and can be sold. A photo alone does not make a product visible.

Frequently asked questions

Does a new import overwrite existing photos?

Yes, a filled image_1920 column replaces the current main image. If you want to keep the old photo for some products, leave those rows out of the import file.

Which file format works best?

JPG for regular product photos, PNG if you need a transparent background. Keep file names simple, without spaces or special characters.

Can I replace all photos in one go later?

Yes. Because you match on external ID or SKU, you simply run the same route again with the new files. Do make an export as a backup first.

Nog één ding

Praktijktip: importeer eerst vijf producten als proef en controleer het resultaat in de webshop voordat u de volledige batch loslaat. Hulp nodig bij een productmigratie of webshoplancering in Odoo? Neem contact op met DAADit Group — wij hebben de scripts al op de plank liggen.

Vraag niet beantwoord?

Onze Odoo-consultants denken graag met u mee. Plan een vrijblijvend kennismakingsgesprek.

Plan een afspraak
Standaardkostprijs versus FIFO voor productwaardering
Wat is het verschil, wat is juist voor uw onderneming, en wat zijn de gevolgen voor uw resultaat?