Shopify begrenzt Produktbilder auf 20 MB und 20 Megapixel; die App verkleinert größere Bilder automatisch. Die meisten Zuordnungsprobleme entstehen durch doppelte Kennungen, leere Kennungen oder kleine Benennungsfehler, und alle sind vor dem Upload in der Vorschau sichtbar.
Grenzen
| Grenze | Wert | Was die App tut |
|---|---|---|
| Dateigröße | 20 MB (Shopify) | Verkleinert und kodiert jpg, jpeg, png, webp, gif neu. Meldet nur dann einen klaren Fehler, wenn es trotzdem nicht passt. |
| Auflösung | 20 Megapixel (Shopify) | Verkleinert auf etwa 18 MP und versucht es erneut. |
| Bilder pro Produkt | 250 (Shopify) | Shopifys eigene Grenze |
| Kostenloser Tarif | 25 Bilder insgesamt | Der Job stoppt mit „Free upload limit reached“. |
| Vorschautabellen | Je 5.000 Zeilen angezeigt | Zähler und CSV-Export umfassen alles. |
| Zuordnungsergebnisse | 2 Stunden aufbewahrt | Bei längerer Wartezeit erneut zuordnen. |
| Shopify-Ratenlimit für Dateien | Shopweit | Automatisches Drosseln (3 s → 6 s → 12 s) und Wiederholen. |
Bilder über den Grenzen werden in einem Warnhinweis auf der Vorschauseite aufgeführt, bevor Sie hochladen.
Empfohlene Werte: JPG oder WEBP, 2048–4096 px an der längsten Kante, sRGB, unter 5 MB.
Wie lange große Uploads dauern
Shopify begrenzt, wie schnell sich Dateien in einem Shop ändern dürfen, und zwar für den gesamten Shop. Die App lädt parallel herunter und hoch und drosselt automatisch, wenn sie die Grenze erreicht. Große Jobs laufen daher gleichmäßig statt schnell. Rechnen Sie bei Zehntausenden Bildern mit Stunden, nicht Minuten. Der Fortschritt wird pro Bild gespeichert, ein Neustart setzt also dort fort, wo er aufgehört hat.
Probleme bei der Zuordnung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Kein Bild zugeordnet | Falsche Zuordnungsart oder falscher Ordner, oder die Kennung ist bei Ihren Varianten leer | Vergleichen Sie die Spalte Expected SKU mit Ihren Produktdaten |
| Einige Bilder nicht zugeordnet | Tippfehler, Leerzeichen am Ende, fehlende Endung, nicht-numerisches Suffix | Exportieren Sie die CSV der nicht zugeordneten Bilder und vergleichen Sie sie mit einem Produktexport |
| Bild der falschen Variante zugeordnet | Doppelte Kennungen oder eine „enthält“-Option trifft einen kürzeren Code | Wechseln Sie zu einer exakten Option oder machen Sie Codes eindeutig |
| Weniger Treffer bei doppelten SKUs | Nur die erste Variante mit einer Kennung wird berücksichtigt | Bitten Sie uns um Zuordnung zu mehreren Varianten oder machen Sie Kennungen eindeutig |
| Titelzuordnung scheitert an Akzenten | Akzente sind in Dateinamen (macOS) anders kodiert als in Shopify | Bitten Sie um Unicode-Normalisierung oder ordnen Sie per SKU zu |
| Bearbeitete Produkte passen noch zu alten Werten | Der Katalog ist zwischengespeichert | Klicken Sie auf Cache leeren |
| Neue Bilder werden nicht aufgelistet | Die Ordnerliste ist zwischengespeichert | Klicken Sie auf Erneut zuordnen oder aktualisieren Sie die Ordnerauswahl |
| Zeitüberschreitung bei der Zuordnung | Sehr großer Katalog und Ordner | Bitten Sie um einen Kollektionsfilter oder teilen Sie den Ordner auf |
Meldungen beim Upload
| Meldung | Bedeutung | Was zu tun ist |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Konnte nicht unter die Grenze verkleinert werden | Exportieren Sie das Bild kleiner |
hit the Shopify file rate limit; retrying in Ns | Normale Drosselung durch Shopify | Nichts. Die App versucht es erneut |
Your shop reached Shopify API rate limit | Eine andere App oder ein anderer Job nutzt die API | Vermeiden Sie zwei große Jobs gleichzeitig |
Free upload limit reached | Die 25 kostenlosen Bilder sind verbraucht | Wechseln Sie in einen höheren Tarif |
This folder already in process | Ein Job für diesen Ordner läuft noch | Warten oder ihn stoppen |
product has only default variant… | Das Bild ging an das Produkt, nicht an eine Variante | Erwartetes Verhalten |
Job endet mit finished with errors | Einige Bilder sind fehlgeschlagen | Lesen Sie die Fehlerzeilen. Fehlgeschlagene Bilder werden automatisch wiederholt |
Checkliste für Ihren Pilotlauf
- Ein Produkt mit einem Bild erhält genau ein Bild, gesetzt als Variantenbild.
- Ein Produkt mit mehreren Bildern erhält sie in der Reihenfolge
_0/_1/_2. - Jede Variante eines Produkts mit mehreren Varianten zeigt ihr eigenes Bild.
- Der Alt-Text in Shopify entspricht der Vorschau.
- Ein absichtlich falscher Dateiname erscheint unter „Nicht zugeordnete Bilder“ und in der CSV.
- Der Ersetzen-Modus hinterlässt bei einem Testprodukt genau die neuen Bilder.
Hilfe erhalten
Kontaktieren Sie uns mit Ihrer Shop-Domain, dem Ordnernamen, der Zuordnungsart, dem ungefähren Zeitpunkt und zwei oder drei Beispiel-Dateinamen mit der SKU oder dem Barcode, zu dem sie hätten passen sollen. Wir können einen Zuordnungslauf vollständig aufzeichnen und Ihnen genau sagen, warum ein Bild so zugeordnet wurde.