Shopify limite les images produits à 20 Mo et 20 mégapixels ; l’app redimensionne automatiquement les images plus lourdes. La plupart des problèmes d’association viennent d’identifiants en double, d’identifiants vides ou de petites erreurs de nommage, tous visibles dans l’aperçu avant l’import.
Limites
| Limite | Valeur | Ce que fait l’app |
|---|---|---|
| Taille de fichier | 20 Mo (Shopify) | Redimensionne et réencode jpg, jpeg, png, webp, gif. N’échoue avec une erreur claire que si l’image ne passe toujours pas. |
| Résolution | 20 mégapixels (Shopify) | Réduit à environ 18 MP et réessaie. |
| Images par produit | 250 (Shopify) | Limite propre à Shopify |
| Forfait gratuit | 25 images au total | La tâche s’arrête avec « Free upload limit reached ». |
| Tableaux de l’aperçu | 5 000 lignes affichées chacun | Les compteurs et l’export CSV couvrent tout. |
| Résultats d’association | Conservés 2 heures | Relancez l’association si vous attendez plus longtemps. |
| Limite de débit des fichiers Shopify | Pour toute la boutique | Pause automatique (3 s → 6 s → 12 s) et nouvelle tentative. |
Les images hors limites sont listées dans un bandeau d’avertissement de l’aperçu avant l’import.
Caractéristiques recommandées : JPG ou WEBP, de 2048 à 4096 px sur le plus grand côté, sRGB, moins de 5 Mo.
Durée des gros imports
Shopify limite la vitesse à laquelle les fichiers d’une boutique peuvent changer, pour toute la boutique. L’app télécharge et importe en parallèle et ralentit automatiquement quand elle atteint la limite : les grosses tâches avancent donc régulièrement plutôt que rapidement. Comptez des heures, pas des minutes, pour des dizaines de milliers d’images. La progression est enregistrée image par image, un redémarrage reprend donc là où il s’était arrêté.
Problèmes d’association
| Symptôme | Cause probable | Solution |
|---|---|---|
| Aucune image associée | Mauvais type d’association ou mauvais dossier, ou identifiant vide sur vos variantes | Comparez la colonne Expected SKU avec vos données produits |
| Certaines images non associées | Fautes de frappe, espaces en fin de nom, extension manquante, suffixe non numérique | Exportez le CSV des images non associées et comparez-le à un export de produits |
| Image associée à la mauvaise variante | Identifiants en double, ou option « contient » qui trouve un code plus court | Passez à une option exacte ou rendez les codes uniques |
| Moins d’associations avec des SKU en double | Seule la première variante portant un identifiant est retenue | Demandez l’association multi-variantes ou rendez les identifiants uniques |
| L’association par titre échoue sur les accents | Les accents sont encodés différemment dans les noms de fichiers (macOS) et dans Shopify | Demandez la normalisation Unicode ou associez par SKU |
| Les produits modifiés correspondent encore aux anciennes valeurs | Le catalogue est en cache | Cliquez sur Vider le cache |
| Les nouvelles images n’apparaissent pas | La liste du dossier est en cache | Cliquez sur Associer à nouveau ou actualisez le sélecteur de dossier |
| L’association dépasse le délai | Catalogue et dossier très volumineux | Demandez un filtre par collection ou divisez le dossier |
Messages d’import
| Message | Signification | Que faire |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Impossible de redimensionner sous la limite | Exportez l’image en plus petit |
hit the Shopify file rate limit; retrying in Ns | Limitation normale de Shopify | Rien. L’app réessaie |
Your shop reached Shopify API rate limit | Une autre app ou tâche utilise l’API | Évitez de lancer deux grosses tâches en même temps |
Free upload limit reached | Les 25 images gratuites sont utilisées | Passez à un forfait supérieur |
This folder already in process | Une tâche pour ce dossier est encore en cours | Attendez ou arrêtez-la |
product has only default variant… | L’image est allée au produit, pas à une variante | Comportement attendu |
La tâche se termine en finished with errors | Certaines images ont échoué | Lisez les lignes d’erreur. Les images en échec sont relancées automatiquement |
Liste de vérification pour votre test pilote
- Un produit à une image reçoit une image, définie comme image de sa variante.
- Un produit à plusieurs images les reçoit dans l’ordre
_0/_1/_2. - Chaque variante d’un produit multi-variantes affiche sa propre image.
- Le texte alt dans Shopify correspond à l’aperçu.
- Un nom de fichier volontairement faux apparaît dans les images non associées et dans le CSV.
- Le mode remplacement sur un produit de test laisse exactement le nouveau jeu d’images.
Obtenir de l’aide
Contactez-nous avec le domaine de votre boutique, le nom du dossier, le type d’association, le moment approximatif du lancement et deux ou trois exemples de noms de fichiers avec le SKU ou le code-barres qu’ils auraient dû trouver. Nous pouvons enregistrer une trace complète d’une association et vous dire exactement pourquoi une image a été associée ainsi.