Shopify begränsar produktbilder till 20 MB och 20 megapixel; appen skalar automatiskt ner större bilder. De flesta matchningsproblem beror på dubbla identifierare, tomma identifierare eller små fel i filnamn, och alla syns i förhandsvisningen innan du laddar upp.
Gränser
| Gräns | Värde | Vad appen gör |
|---|---|---|
| Filstorlek | 20 MB (Shopify) | Skalar ner och kodar om jpg, jpeg, png, webp, gif. Ger ett tydligt fel bara om filen ändå inte får plats. |
| Upplösning | 20 megapixel (Shopify) | Skalar ner till cirka 18 MP och försöker igen. |
| Bilder per produkt | 250 (Shopify) | Shopifys egen gräns |
| Gratisplan | 25 bilder totalt | Jobbet stoppas med “Free upload limit reached”. |
| Förhandsvisningens tabeller | 5 000 rader visas i varje | Räknarna och CSV-exporten omfattar allt. |
| Matchningsresultat | Sparas i 2 timmar | Matcha igen om du väntar längre. |
| Shopifys hastighetsgräns för filer | Gäller hela butiken | Automatisk paus (3 s → 6 s → 12 s) och nytt försök. |
Bilder över gränserna listas i en varning på förhandsvisningssidan innan du laddar upp.
Rekommenderade specifikationer: JPG eller WEBP, 2048 till 4096 px på längsta sidan, sRGB, under 5 MB.
Hur lång tid stora uppladdningar tar
Shopify begränsar hur snabbt filer i en butik får ändras, för hela butiken. Appen laddar ner och upp parallellt och saktar automatiskt in när gränsen nås, så stora jobb går jämnt snarare än snabbt. Räkna med timmar, inte minuter, för tiotusentals bilder. Förloppet sparas per bild, så en omstart fortsätter där det stannade.
Matchningsproblem
| Symptom | Trolig orsak | Lösning |
|---|---|---|
| Inga bilder matchade | Fel matchningstyp eller mapp, eller identifieraren är tom på dina varianter | Jämför kolumnen Expected SKU med dina produktdata |
| Vissa bilder omatchade | Stavfel, mellanslag i slutet, saknad filändelse, suffix som inte är ett tal | Exportera CSV:n med omatchade bilder och jämför med en produktexport |
| Bilden matchade fel variant | Dubbla identifierare, eller ett “innehåller”-alternativ som träffar en kortare kod | Byt till ett exakt alternativ eller gör koderna unika |
| Färre matchningar med dubbla SKU:er | Bara den första varianten med en identifierare behålls | Be om matchning mot flera varianter eller gör identifierarna unika |
| Titelmatchning misslyckas med accenter | Accenterna är kodade olika i filnamn (macOS) och i Shopify | Be om Unicode-normalisering eller matcha på SKU |
| Redigerade produkter matchar fortfarande gamla värden | Katalogen är cachad | Klicka på Rensa cache |
| Nya bilder visas inte | Mapplistan är cachad | Klicka på Matcha igen eller uppdatera mappväljaren |
| Matchningen får tidsgränsen | Mycket stor katalog och mapp | Be om ett kollektionsfilter eller dela upp mappen |
Uppladdningsmeddelanden
| Meddelande | Betydelse | Vad du gör |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Kunde inte skalas ner under gränsen | Exportera bilden i mindre storlek |
hit the Shopify file rate limit; retrying in Ns | Vanlig strypning från Shopify | Inget. Appen försöker igen |
Your shop reached Shopify API rate limit | En annan app eller ett annat jobb använder API:t | Undvik att köra två stora jobb samtidigt |
Free upload limit reached | De 25 gratisbilderna är förbrukade | Uppgradera din plan |
This folder already in process | Ett jobb för mappen pågår fortfarande | Vänta eller stoppa det |
product has only default variant… | Bilden gick till produkten, inte till en variant | Förväntat beteende |
Jobbet avslutas med finished with errors | Vissa bilder misslyckades | Läs felraderna. Misslyckade bilder görs om automatiskt |
Checklista för ditt pilottest
- En produkt med en bild får exakt en bild, inställd som variantbild.
- En produkt med flera bilder får dem i ordningen
_0/_1/_2. - Varje variant av en produkt med flera varianter visar sin egen bild.
- Alttexten i Shopify stämmer med förhandsvisningen.
- Ett medvetet felaktigt filnamn hamnar bland de omatchade bilderna och i CSV-filen.
- Ersättningsläget på en testprodukt lämnar exakt den nya uppsättningen.
Få hjälp
Kontakta oss med din butiksdomän, mappnamnet, matchningstypen, ungefär när du körde den och två eller tre exempel på filnamn med den SKU eller streckkod de borde ha matchat. Vi kan spela in ett fullständigt spår av en matchningskörning och berätta exakt varför en bild matchade som den gjorde.