Shopify beperkt productafbeeldingen tot 20 MB en 20 megapixel; de app verkleint grotere afbeeldingen automatisch. De meeste koppelproblemen komen door dubbele kenmerken, lege kenmerken of kleine fouten in bestandsnamen, en die zie je allemaal in het voorbeeld voordat je uploadt.
Limieten
| Limiet | Waarde | Wat de app doet |
|---|---|---|
| Bestandsgrootte | 20 MB (Shopify) | Verkleint en codeert jpg, jpeg, png, webp, gif opnieuw. Geeft alleen een duidelijke fout als het daarna nog steeds niet past. |
| Resolutie | 20 megapixel (Shopify) | Verkleint naar ongeveer 18 MP en probeert opnieuw. |
| Afbeeldingen per product | 250 (Shopify) | De eigen limiet van Shopify |
| Gratis abonnement | 25 afbeeldingen in totaal | De taak stopt met “Free upload limit reached”. |
| Voorbeeldtabellen | Elk 5.000 rijen zichtbaar | Tellers en CSV-export bevatten alles. |
| Koppelresultaten | 2 uur bewaard | Koppel opnieuw als je langer wacht. |
| Snelheidslimiet voor bestanden van Shopify | Voor de hele winkel | Automatisch afremmen (3 s → 6 s → 12 s) en opnieuw proberen. |
Afbeeldingen boven de limieten staan vóór de upload in een waarschuwing op de voorbeeldpagina.
Aanbevolen specificaties: JPG of WEBP, 2048 tot 4096 px aan de langste zijde, sRGB, kleiner dan 5 MB.
Hoe lang grote uploads duren
Shopify beperkt hoe snel bestanden in een winkel mogen veranderen, voor de hele winkel. De app downloadt en uploadt parallel en remt automatisch af als de limiet is bereikt, dus grote taken lopen gestaag in plaats van snel. Reken bij tienduizenden afbeeldingen op uren, niet op minuten. De voortgang wordt per afbeelding opgeslagen, dus na een herstart gaat het verder waar het stopte.
Koppelproblemen
| Symptoom | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
| Geen enkele afbeelding gekoppeld | Verkeerd koppeltype of verkeerde map, of het kenmerk is leeg bij je varianten | Vergelijk de kolom Expected SKU met je productgegevens |
| Sommige afbeeldingen niet gekoppeld | Typefouten, spaties aan het eind, ontbrekende extensie, achtervoegsel zonder getal | Exporteer de CSV met niet-gekoppelde afbeeldingen en vergelijk die met een productexport |
| Afbeelding aan de verkeerde variant gekoppeld | Dubbele kenmerken, of een “bevat”-optie die een kortere code vindt | Kies een exacte optie of maak codes uniek |
| Minder koppelingen bij dubbele SKU’s | Alleen de eerste variant met een kenmerk wordt meegenomen | Vraag om koppelen aan meerdere varianten of maak kenmerken uniek |
| Koppelen op titel mislukt bij accenten | Accenten zijn in bestandsnamen (macOS) anders gecodeerd dan in Shopify | Vraag om Unicode-normalisatie of koppel op SKU |
| Bewerkte producten matchen nog met oude waarden | De catalogus staat in de cache | Klik op Cache wissen |
| Nieuwe afbeeldingen verschijnen niet | De maplijst staat in de cache | Klik op Opnieuw koppelen of vernieuw de mapkeuze |
| Koppelen loopt in een time-out | Zeer grote catalogus en map | Vraag om een collectiefilter of splits de map |
Uploadmeldingen
| Melding | Betekenis | Wat te doen |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Kon niet onder de limiet worden verkleind | Exporteer de afbeelding kleiner |
hit the Shopify file rate limit; retrying in Ns | Normale afremming door Shopify | Niets. De app probeert het opnieuw |
Your shop reached Shopify API rate limit | Een andere app of taak gebruikt de API | Draai niet twee grote taken tegelijk |
Free upload limit reached | De 25 gratis afbeeldingen zijn op | Upgrade je abonnement |
This folder already in process | Er loopt nog een taak voor deze map | Wacht of stop de taak |
product has only default variant… | De afbeelding ging naar het product, niet naar een variant | Verwacht gedrag |
Taak eindigt met finished with errors | Sommige afbeeldingen zijn mislukt | Lees de foutregels. Mislukte afbeeldingen worden automatisch opnieuw geprobeerd |
Checklist voor je proefrun
- Een product met één afbeelding krijgt precies één afbeelding, ingesteld als variantafbeelding.
- Een product met meerdere afbeeldingen krijgt ze in de volgorde
_0/_1/_2. - Elke variant van een product met meerdere varianten toont zijn eigen afbeelding.
- De alttekst in Shopify komt overeen met het voorbeeld.
- Een bewust verkeerde bestandsnaam verschijnt bij de niet-gekoppelde afbeeldingen en in de CSV.
- De vervangmodus laat bij een testproduct precies de nieuwe set achter.
Hulp krijgen
Neem contact op met je winkeldomein, de mapnaam, het koppeltype, ongeveer wanneer je het startte en twee of drie voorbeelden van bestandsnamen met de SKU of barcode waarmee ze hadden moeten overeenkomen. We kunnen een volledige trace van een koppelrun vastleggen en je precies vertellen waarom een afbeelding zo is gekoppeld.