Como nomear seus arquivos de imagem

Nomeie cada imagem com o identificador a que ela pertence, seguido opcionalmente de um sublinhado e um número para a posição: <identificador>_<ordem>.<extensão>.

A regra

O app transforma um nome de arquivo em uma chave de associação em três etapas:

1. Remove a extensão: tudo o que vem depois do último ..
2. Se a parte depois do último sublinhado for um número, esse número é a ordem da imagem e tudo antes dele é o identificador. Caso contrário, o nome inteiro é o identificador.
3. Converte o identificador para minúsculas. A associação não diferencia maiúsculas de minúsculas dos dois lados.

Exemplos

Nome do arquivo	Identificador usado	Ordem	Observações
AB-1234.jpg	ab-1234	1ª	Imagem única da variante
AB-1234_0.jpg	ab-1234	1ª	_0 e sem sufixo significam o mesmo
AB-1234_1.jpg	ab-1234	2ª
AB-1234_2.png	ab-1234	3ª
7891234567890_1.jpg	7891234567890	2ª	Associação por código de barras/EAN
RED-SHIRT_M.jpg	red-shirt_m	1ª	M não é número, então continua no identificador
AB_12_3.jpg	ab_12	4ª	Só o último segmento é a ordem
AB-1234.v2.jpg	ab-1234.v2	1ª	Só o texto depois do último ponto é a extensão
AB-1234	(vazio)	nenhuma	Nunca associa. Arquivos precisam de extensão

Ordem das imagens

Use o sufixo numérico para controlar a ordem da galeria:

AB-1234_0.jpg  →  1ª imagem (também a imagem da variante)
AB-1234_1.jpg  →  2ª imagem
AB-1234_2.jpg  →  3ª imagem

• Só a ordem relativa importa. _1, _3, _7 dá a mesma ordem que _1, _2, _3.
• Sem sufixo significa primeira. AB-1234.jpg e AB-1234_0.jpg são equivalentes, então não use os dois.
• O menor número vira a imagem da variante. Dê o menor número à foto principal.
• Sem o modo de substituição, as novas imagens são adicionadas depois das que o produto já tem.
• Números de ordem acima de 999 são limitados.

O que fazer

• Manter os identificadores exatamente como estão na Shopify (maiúsculas não importam, todo o resto importa).
• Usar _0, _1, _2… ou _1, _2, _3… de forma consistente.
• Usar .jpg, .jpeg, .png, .webp ou .gif.
• Manter nomes de arquivo únicos dentro da pasta.

O que evitar

• Não adicione espaços no final (AB-1234 .jpg). O espaço passa a fazer parte do identificador. Os valores na Shopify são aparados; os nomes de arquivo, não.
• Não comece um nome com sublinhado (_AB-1234.jpg).
• Não envie arquivos sem extensão.
• Não use letras para a ordem (AB-1234_a.jpg procura ab-1234_a).
• Não misture convenções em uma pasta (alguns arquivos com _1 e outros com -1).

Quando os nomes dos arquivos não seguem os seus SKUs

Nem sempre é preciso renomear milhares de arquivos:

• Use um tipo de associação “contém” quando os nomes têm texto extra (veja Tipos de associação).
• Guarde o código da imagem em um metacampo e associe por ele.
• Use a associação com IA (beta) para nomes inconsistentes.
• Peça regras de limpeza de identificadores, por exemplo para ignorar tudo depois do primeiro hífen de um SKU.