Nommer vos fichiers image

Nommez chaque image d’après l’identifiant auquel elle appartient, suivi si besoin d’un tiret bas et d’un numéro pour sa position : <identifiant>_<ordre>.<extension>.

La règle

L’app transforme un nom de fichier en clé d’association en trois étapes :

1. Retirer l’extension : tout ce qui suit le dernier ..
2. Si la partie après le dernier tiret bas est un nombre, ce nombre est l’ordre de l’image et tout ce qui précède est l’identifiant. Sinon, le nom entier est l’identifiant.
3. Passer l’identifiant en minuscules. L’association ignore les majuscules des deux côtés.

Exemples

Nom de fichier	Identifiant utilisé	Ordre	Remarques
AB-1234.jpg	ab-1234	1re	Image unique de la variante
AB-1234_0.jpg	ab-1234	1re	_0 et l’absence de suffixe reviennent au même
AB-1234_1.jpg	ab-1234	2e
AB-1234_2.png	ab-1234	3e
7891234567890_1.jpg	7891234567890	2e	Association par code-barres/EAN
RED-SHIRT_M.jpg	red-shirt_m	1re	M n’est pas un nombre, il reste dans l’identifiant
AB_12_3.jpg	ab_12	4e	Seul le dernier segment est l’ordre
AB-1234.v2.jpg	ab-1234.v2	1re	Seul le texte après le dernier point est l’extension
AB-1234	(vide)	aucun	Jamais associé. Les fichiers ont besoin d’une extension

Ordre des images

Le suffixe numérique contrôle l’ordre de la galerie :

AB-1234_0.jpg  →  1re image (aussi l'image de la variante)
AB-1234_1.jpg  →  2e image
AB-1234_2.jpg  →  3e image

• Seul l’ordre relatif compte. _1, _3, _7 donne le même ordre que _1, _2, _3.
• Pas de suffixe signifie première position. AB-1234.jpg et AB-1234_0.jpg sont équivalents, n’utilisez donc pas les deux.
• Le plus petit numéro devient l’image de la variante. Donnez le plus petit numéro à la photo principale.
• Sans le mode remplacement, les nouvelles images s’ajoutent après celles que le produit possède déjà.
• Les numéros d’ordre supérieurs à 999 sont plafonnés.

À faire

• Garder les identifiants exactement comme dans Shopify (la casse n’a pas d’importance, tout le reste en a).
• Utiliser _0, _1, _2… ou _1, _2, _3… de façon cohérente.
• Utiliser .jpg, .jpeg, .png, .webp ou .gif.
• Garder des noms de fichiers uniques dans le dossier.

À éviter

• Pas d’espace en fin de nom (AB-1234 .jpg). L’espace fait partie de l’identifiant. Les valeurs de Shopify sont nettoyées, pas les noms de fichiers.
• Ne pas commencer un nom par un tiret bas (_AB-1234.jpg).
• Ne pas importer de fichiers sans extension.
• Pas de lettres pour l’ordre (AB-1234_a.jpg cherche ab-1234_a).
• Ne pas mélanger les conventions dans un dossier (certains fichiers avec _1, d’autres avec -1).

Quand vos noms de fichiers ne suivent pas vos SKU

Vous n’avez pas toujours besoin de renommer des milliers de fichiers :

• Utilisez un type d’association « contient » quand les noms comportent du texte en plus (voir Types d’association).
• Placez votre code image dans un métachamp et associez sur ce champ.
• Utilisez l’association par IA (bêta) pour les noms peu homogènes.
• Demandez-nous des règles de nettoyage des identifiants, par exemple pour ignorer tout ce qui suit le premier tiret d’un SKU.