Migração de imagens de produto: ordem e esquema de nomes
Porque as imagens são difíceis, esquema de nomes, sequência de oito passos, resolução e formato, textos alternativos e redirecionamentos.
Numa migração, o catálogo passa depressa. As imagens são a parte que demora o dobro do previsto — e que no fim decide o tempo de carregamento do novo site.
Porque as imagens são a parte difícil
Um produto tem um registo. Uma imagem de produto tem um registo, um ficheiro, uma associação ao produto, uma posição na galeria, uma associação a variante e um texto alternativo. Com 800 produtos e quatro imagens cada, são 3.200 ficheiros com cerca de 20.000 informações individuais que têm de estar certas.
Situação inicial frequente em lojas que cresceram:
- Nomes de ficheiro como
IMG_4821.JPG, por vezes repetidos - Imagens em quatro resoluções diferentes sem regra reconhecível
- Imagens de variante associadas apenas pela posição e não pela SKU
- Textos alternativos vazios ou preenchidos com o nome da empresa
- Ficheiros órfãos cujo produto foi apagado
O esquema de nomes
Um nome de ficheiro não é um fator de posicionamento, mas é um elemento de associação. Dois requisitos:
- Inequívoco. Nenhum nome pode ocorrer duas vezes — caso contrário a importação substitui um ficheiro.
- Rastreável. O nome tem de indicar a que produto e a que posição pertence a imagem.
Um esquema que cumpre ambos:
wb-1042-01.jpg (Produkt, Bild 1)
wb-1042-02.jpg (Produkt, Bild 2)
wb-1042-sw-m-01.jpg (Variante, Bild 1)
O nome do produto no ficheiro não é necessário. Muda, a SKU não. Quem quiser ambos pode acrescentar o nome — mas só se a SKU estiver à frente, para que a associação continue inequívoca por máquina.
Sequência que funciona
- Exportação: obter todos os URLs de imagem com ID de produto, SKU e posição a partir do sistema de origem.
- Confronto: verificar quais dos URLs estão realmente acessíveis. Resolver primeiro as ligações mortas — caso contrário faltam depois sem se notar.
- Limpeza: registar imagens órfãs e duplicados, mas não apagar de imediato.
- Renomeação: renomear segundo o esquema, numa cópia — nunca no conjunto original.
- Formato: converter para WebP ou AVIF, com resolução de destino definida.
- Carregamento: carregar no ambiente de destino, com a SKU como chave de associação.
- Verificar a associação: comparar o número de imagens por produto com a origem.
- Redirecionamentos: redirecionar os URLs antigos de imagem para os novos, se estiverem indexados ou ligados.
O passo dois é regularmente omitido. Em qualquer catálogo que cresceu, 2 a 5 % dos URLs de imagem já não estão acessíveis — geralmente porque ficheiros foram apagados manualmente. Quem não verifica antes só o descobre quando os clientes veem galerias vazias.
Resolução e formato: uma vez bem, não duas
A migração é o único momento barato para uniformizar dimensões de imagem. Dois valores chegam, em regra:
| Utilização | Largura | Formato |
|---|---|---|
| Miniatura na categoria | 600 px | WebP, qualidade 80 |
| Página de produto e zoom | 1.600 px | WebP, qualidade 82 |
Tudo o que está acima raramente é necessário na loja e custa tempo de carregamento. Tudo o que está abaixo impede o zoom e parece desfocado em ecrãs de alta resolução.
Importante: as variantes menores devem ser geradas no sistema de destino e não fornecidas. O WordPress gera-as no carregamento — desde que o ficheiro original seja suficientemente grande e as dimensões estejam definidas no tema. Quem carrega apenas a versão de 600 píxeis não pode mais tarde gerar uma variante maior sem obter de novo a fonte.
Textos alternativos: utilidade antes de palavra-chave
O texto alternativo tem duas funções: acessibilidade e contexto para os motores de busca. Ambas são servidas pelo mesmo conteúdo — uma descrição objetiva.
Bons padrões:
Mala de couro preta, vista lateralCamisa de algodão, tamanho M, frenteDetalhe do produto: fecho e forro interior
Maus padrões:
comprar mala de couro barata melhor qualidade– acumulação de palavras-chaveIMG_4821– nenhuma informaçãoImagem– nenhuma informação- Vazio – desperdiça acessibilidade e contexto
Com 3.200 imagens, o trabalho manual é irrealista. Um texto gerado a partir do nome do produto, da variante e da posição é claramente melhor do que um texto alternativo vazio — e nos casos que contam (imagem principal, imagem de categoria, página inicial) faz-se uma correção manual.
Imagens de variante: o erro de associação mais frequente
As imagens de variante são muitas vezes associadas pela posição: “a imagem 3 pertence à segunda variante”. Isso só funciona enquanto a ordem nunca mudar. Após uma importação em que falta uma imagem, tudo se desloca.
O correto é a associação pela SKU da variante. Se isso não existir no sistema de origem, tem de ser acrescentado antes da exportação — depois, a associação passa a ser manual e, por isso, sujeita a erro.
Verificação após a importação: para cada variante com imagem própria, confirmar que é apresentada a imagem correta. Uma amostra não chega — com 40 variantes o esforço é de meia hora e evita reclamações.
URLs antigos de imagem e redirecionamentos
As imagens raramente são ligadas diretamente, mas são indexadas — através da pesquisa de imagens e de referências incorporadas em páginas externas. Ao mudar de sistema de ficheiros, os URLs mudam.
Dois casos:
- Mesmo domínio, novo caminho: um redirecionamento por padrão de caminho antigo é suficiente e evita erros 404 na pesquisa de imagens.
- Novo domínio: sem redirecionamento perdem-se todas as referências de imagem. Raramente é crítico para o posicionamento, mas gera erros na Search Console e em incorporações externas.
Uma matriz de redirecionamentos com uma entrada por padrão chega. Uma entrada por ficheiro não é sustentável com milhares de imagens — e geralmente também não é necessária.
Lista de verificação
- Exportar todos os URLs de imagem com SKU e posição
- Verificar a acessibilidade, resolver as ligações mortas
- Definir o esquema de nomes e aplicá-lo numa cópia
- Definir a resolução e o formato de destino
- Carregar os originais com dimensão suficiente
- Associar pela SKU e não pela posição
- Verificar o número de imagens por produto contra a origem
- Gerar textos alternativos e corrigir os das imagens principais
- Criar redirecionamentos para os padrões de caminho antigos
- Verificar a imagem LCP na página inicial e na categoria
Quem respeita esta sequência tem, após a migração, um catálogo cujas imagens carregam mais depressa do que antes — em vez de uma coleção apenas transferida tecnicamente. Isto faz parte da otimização do tempo de carregamento e atua imediatamente nas páginas comerciais mais importantes.