A Shopify limita as imagens de produto a 20 MB e 20 megapixels; o app redimensiona automaticamente as imagens maiores. A maioria dos problemas de associação vem de identificadores duplicados, identificadores vazios ou pequenos erros de nome, e todos aparecem na prévia antes do envio.
Limites
| Limite | Valor | O que o app faz |
|---|---|---|
| Tamanho do arquivo | 20 MB (Shopify) | Redimensiona e recodifica jpg, jpeg, png, webp, gif. Só falha com um erro claro se ainda assim não couber. |
| Resolução | 20 megapixels (Shopify) | Reduz para cerca de 18 MP e tenta de novo. |
| Imagens por produto | 250 (Shopify) | Limite da própria Shopify |
| Plano gratuito | 25 imagens no total | O trabalho para com “Free upload limit reached”. |
| Tabelas da prévia | 5.000 linhas exibidas em cada | Os contadores e o CSV cobrem tudo. |
| Resultados da associação | Guardados por 2 horas | Associe de novo se esperar mais. |
| Limite de taxa de arquivos da Shopify | Para a loja inteira | Pausa automática (3 s → 6 s → 12 s) e nova tentativa. |
As imagens acima dos limites aparecem em um aviso na prévia antes do envio.
Especificações recomendadas: JPG ou WEBP, de 2048 a 4096 px no lado maior, sRGB, menos de 5 MB.
Quanto tempo levam os envios grandes
A Shopify limita a velocidade com que os arquivos de uma loja podem mudar, para a loja inteira. O app baixa e envia em paralelo e reduz o ritmo automaticamente ao atingir o limite, então os trabalhos grandes avançam de forma constante, não rápida. Conte com horas, não minutos, para dezenas de milhares de imagens. O progresso é salvo por imagem, então uma reinicialização continua de onde parou.
Problemas de associação
| Sintoma | Causa provável | Solução |
|---|---|---|
| Nenhuma imagem associada | Tipo de associação ou pasta errados, ou identificador vazio nas suas variantes | Compare a coluna Expected SKU com os dados dos seus produtos |
| Algumas imagens não associadas | Erros de digitação, espaços no final, extensão ausente, sufixo não numérico | Exporte o CSV das imagens não associadas e compare com uma exportação de produtos |
| Imagem associada à variante errada | Identificadores duplicados, ou uma opção “contém” que encontrou um código mais curto | Mude para uma opção exata ou torne os códigos únicos |
| Menos associações com SKUs duplicados | Só a primeira variante com cada identificador é mantida | Peça a associação com várias variantes ou torne os identificadores únicos |
| A associação por título falha com acentos | Os acentos são codificados de forma diferente nos nomes de arquivo (macOS) e na Shopify | Peça a normalização Unicode ou associe por SKU |
| Produtos editados ainda correspondem a valores antigos | O catálogo está em cache | Clique em Limpar cache |
| Imagens novas não aparecem | A lista da pasta está em cache | Clique em Associar de novo ou atualize o seletor de pasta |
| A associação excede o tempo limite | Catálogo e pasta muito grandes | Peça um filtro por coleção ou divida a pasta |
Mensagens de envio
| Mensagem | Significado | O que fazer |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | Não foi possível reduzir abaixo do limite | Exporte a imagem menor |
hit the Shopify file rate limit; retrying in Ns | Limitação normal da Shopify | Nada. O app tenta de novo |
Your shop reached Shopify API rate limit | Outro app ou trabalho está usando a API | Evite rodar dois trabalhos grandes ao mesmo tempo |
Free upload limit reached | As 25 imagens gratuitas foram usadas | Faça upgrade do plano |
This folder already in process | Ainda há um trabalho em andamento para a pasta | Aguarde ou interrompa-o |
product has only default variant… | A imagem foi para o produto, não para uma variante | Comportamento esperado |
O trabalho termina com finished with errors | Algumas imagens falharam | Leia as linhas de erro. As imagens com falha são repetidas automaticamente |
Lista de verificação para o seu piloto
- Um produto com uma imagem recebe uma imagem, definida como imagem da variante.
- Um produto com várias imagens as recebe na ordem
_0/_1/_2. - Cada variante de um produto com várias variantes mostra a própria imagem.
- O texto alt na Shopify corresponde à prévia.
- Um nome de arquivo errado de propósito aparece nas imagens não associadas e no CSV.
- O modo de substituição em um produto de teste deixa exatamente o novo conjunto.
Como obter ajuda
Fale conosco informando o domínio da loja, o nome da pasta, o tipo de associação, quando você executou mais ou menos e dois ou três exemplos de nomes de arquivo com o SKU ou código de barras com que deveriam ter correspondido. Podemos registrar um rastreamento completo de uma associação e dizer exatamente por que uma imagem correspondeu ao que correspondeu.