Shopify limita le immagini dei prodotti a 20 MB e 20 megapixel; l’app ridimensiona automaticamente le immagini più grandi. La maggior parte dei problemi di abbinamento deriva da identificatori duplicati, identificatori vuoti o piccoli errori nei nomi, tutti visibili nell’anteprima prima del caricamento.
Limiti
| Limite | Valore | Cosa fa l’app |
|---|---|---|
| Dimensione del file | 20 MB (Shopify) | Ridimensiona e ricodifica jpg, jpeg, png, webp, gif. Si ferma con un errore chiaro solo se il file continua a non rientrare. |
| Risoluzione | 20 megapixel (Shopify) | Riduce a circa 18 MP e riprova. |
| Immagini per prodotto | 250 (Shopify) | Limite di Shopify |
| Piano gratuito | 25 immagini in totale | Il processo si ferma con “Free upload limit reached”. |
| Tabelle dell’anteprima | 5.000 righe visibili ciascuna | I contatori e l’esportazione CSV includono tutto. |
| Risultati dell’abbinamento | Conservati 2 ore | Ripeti l’abbinamento se aspetti di più. |
| Limite di velocità dei file di Shopify | Per tutto il negozio | Pausa automatica (3 s → 6 s → 12 s) e nuovo tentativo. |
Le immagini fuori limite sono elencate in un avviso nella pagina di anteprima prima del caricamento.
Specifiche consigliate: JPG o WEBP, da 2048 a 4096 px sul lato più lungo, sRGB, sotto i 5 MB.
Quanto durano i caricamenti grandi
Shopify limita la velocità con cui i file di un negozio possono cambiare, per l’intero negozio. L’app scarica e carica in parallelo e rallenta automaticamente quando raggiunge il limite, quindi i processi grandi avanzano in modo costante, non veloce. Per decine di migliaia di immagini, conta ore e non minuti. L’avanzamento viene salvato per ogni immagine, quindi un riavvio riprende da dove si era fermato.
Problemi di abbinamento
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Nessuna immagine abbinata | Tipo di abbinamento o cartella sbagliati, oppure identificatore vuoto nelle varianti | Confronta la colonna Expected SKU con i dati dei tuoi prodotti |
| Alcune immagini non abbinate | Errori di battitura, spazi finali, estensione mancante, suffisso non numerico | Esporta il CSV delle immagini non abbinate e confrontalo con un’esportazione dei prodotti |
| Immagine abbinata alla variante sbagliata | Identificatori duplicati, oppure un’opzione “contiene” che trova un codice più corto | Passa a un’opzione esatta o rendi unici i codici |
| Meno abbinamenti con SKU duplicati | Viene mantenuta solo la prima variante con ciascun identificatore | Chiedici l’abbinamento su più varianti o rendi unici gli identificatori |
| L’abbinamento per titolo non funziona con gli accenti | Gli accenti sono codificati in modo diverso nei nomi dei file (macOS) e in Shopify | Chiedi la normalizzazione Unicode o abbina per SKU |
| I prodotti modificati corrispondono ancora ai vecchi valori | Il catalogo è nella cache | Fai clic su Svuota cache |
| Le nuove immagini non compaiono | L’elenco della cartella è nella cache | Fai clic su Abbina di nuovo o aggiorna il selettore della cartella |
| L’abbinamento va in timeout | Catalogo e cartella molto grandi | Chiedi un filtro per collezione o dividi la cartella |
Messaggi di caricamento
| Messaggio | Significato | Cosa fare |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Impossibile ridimensionare sotto il limite | Esporta l’immagine in formato più piccolo |
hit the Shopify file rate limit; retrying in Ns | Normale limitazione di Shopify | Niente. L’app riprova |
Your shop reached Shopify API rate limit | Un’altra app o un altro processo sta usando l’API | Evita di avviare due processi grandi insieme |
Free upload limit reached | Le 25 immagini gratuite sono esaurite | Passa a un piano superiore |
This folder already in process | C’è ancora un processo in corso per la cartella | Attendi o interrompilo |
product has only default variant… | L’immagine è andata al prodotto, non a una variante | Comportamento previsto |
Il processo termina con finished with errors | Alcune immagini non sono riuscite | Leggi le righe di errore. Le immagini non riuscite vengono ripetute automaticamente |
Checklist per il tuo test pilota
- Un prodotto con un’immagine riceve una sola immagine, impostata come immagine della variante.
- Un prodotto con più immagini le riceve nell’ordine
_0/_1/_2. - Ogni variante di un prodotto con più varianti mostra la propria immagine.
- Il testo alternativo in Shopify corrisponde all’anteprima.
- Un nome di file volutamente errato compare tra le immagini non abbinate e nel CSV.
- La modalità sostituzione su un prodotto di prova lascia esattamente il nuovo set.
Come ricevere assistenza
Contattaci indicando il dominio del negozio, il nome della cartella, il tipo di abbinamento, più o meno quando l’hai avviato e due o tre nomi di file di esempio con lo SKU o il codice a barre a cui avrebbero dovuto corrispondere. Possiamo registrare una traccia completa di un abbinamento e dirti esattamente perché un’immagine è stata abbinata in quel modo.