Wer einen Magento-2-Shop mit 10.000 Artikeln neu aufsetzt, lädt keine Bilder einzeln hoch. Der Massenimport von Produktbildern über CSV-Dateien ist in Adobe Commerce und Magento Open Source nach wie vor der Standardweg, und 2026 genauso fehleranfällig wie eh und je, wenn man die Spielregeln nicht kennt.
Adobe hat am Grundprinzip seit den aktuellen 2.4.7er-Releases nichts Grundlegendes geändert: Der Produktimport läuft über System → Data Transfer → Import, die Bildpfade stehen in den Spalten base_image, small_image, thumbnail_image und additional_images. Was viele übersehen: Die Bilddateien selbst wandern nicht in die CSV, sondern müssen vorab auf den Server, standardmäßig in das Verzeichnis pub/media/import beziehungsweise den in der Import-Konfiguration hinterlegten Pfad. In der CSV steht dann nur der relative Dateiname mit führendem Slash, etwa /sneaker-rot-frontal.jpg.
Wie funktioniert der CSV-Bildimport in Magento 2 konkret?
Die kurze Antwort: CSV hochladen, Importtyp „Products“ wählen, Verhalten auf „Add/Update“ stellen, Bildpfad im Feld „Images File Directory“ angeben, Validierung laufen lassen, Import starten. Magento ordnet die Bilder anhand der SKU zu, die SKU ist damit der entscheidende Schlüssel der gesamten Datei. Ohne exakt passende SKU-Zeile landet kein Bild im Katalog.
Mehrere Zusatzbilder pro Artikel werden kommagetrennt in additional_images gepflegt. Wer Galerie-Sortierung, Alt-Texte und Verknüpfungen zu konfigurierbaren Produkten sauber abbilden will, nutzt die Spalten additional_image_labels und definiert Rollen pro Store View über die _store-Spalte. Gerade Mehrsprachen-Shops unterschätzen diesen Schritt: Alt-Texte pro Store View sind kein Luxus, sondern SEO-Pflicht, Google wertet sie seit den jüngsten Bildersuche-Updates deutlich stärker.
Artikel.JPG und artikel.jpg.Warum scheitern so viele Massenimporte?
Die Fehlerstatistik aus Agenturprojekten ist eindeutig. Auf Platz eins: fehlende Schreibrechte auf dem Import-Verzeichnis. Auf Platz zwei: Leerzeichen und Umlaute in Dateinamen, die Magento zwar validiert, aber beim Abgleich mit den physischen Dateien scheitern lässt. Platz drei: Importe mit mehreren tausend Datensätzen, die am PHP-Timeout oder am Speicherlimit sterben, weil niemand den Import in Batches von 500 bis 1.000 Zeilen aufgeteilt hat.
Wer 20.000 SKUs in einer einzigen CSV durchjagt, bekommt keinen schnelleren Import, nur einen abgebrochenen.
Hinzu kommt ein Klassiker bei Update-Läufen: Das Verhalten „Replace“ löscht bestehende Produktzuordnungen, bevor es neu schreibt. Für reine Bild-Updates ist „Add/Update“ die sichere Wahl. Und nach jedem Import gilt: Cache leeren, Katalog-Bilder über bin/magento catalog:images:resize neu generieren lassen, sonst zeigt das Frontend leere Platzhalter.
Tools für den Shop-Alltag
Der Bordmittel-Import reicht für die meisten Fälle. Bei wiederkehrenden Feeds aus Warenwirtschaft oder PIM, etwa von JTL-Wawi oder Akeneo, sparen Extensions wie Improved Import & Export von Firebear oder die Import-Profile in Mageworx-Lösungen echte Zeit: geplante Cronjob-Importe, SFTP-Anbindung, Mapping-Vorlagen. Wer ohnehin ein PIM betreibt, fährt mit der nativen REST-API (POST /V1/products/{sku}/media) oft besser als mit CSV-Dateien.
Unser Rat an Betreiber: Testen Sie jeden Massenimport zuerst mit einer 20-Zeilen-Stichprobe auf der Staging-Umgebung. Der Import-Check in Magento meldet Formatfehler zuverlässig, bevor der Produktivkatalog darunter leidet. Gerade bei den für 2026 anstehenden Katalog-Migrationen auf neuere 2.4.8-Versionen ist ein sauber dokumentierter Import-Prozess kein Nice-to-have, sondern die halbe Miete.