← Blog
5 min de leitura

Nomes de Arquivo de Imagens de Produto que Escalam

Um padrão de nome em três campos — SKU, código de vista e fundo — que mantém o catálogo pesquisável e automatizável, e os caracteres que o quebram.

  • product photography
  • file naming
  • ecommerce
  • catalogue management
  • workflow
  • background removal
  • bulk processing
Nomes de Arquivo de Imagens de Produto que Escalam

Alguém pede a vista traseira do TS-4410 sobre fundo branco. Você abre o drive compartilhado e encontra IMG_4471 copy 2 final.png, IMG_4471 copy 2 final (1).png e uma pasta chamada NEW EDITS USE THESE. Dez minutos depois, você ainda está abrindo miniaturas.

Uma convenção de nomes é a correção mais barata das operações de catálogo: uma tarde de acordo, nenhum software novo, e ela sobrevive a quem quer que tenha feito as fotos. Aqui está um padrão que se sustenta ao longo de alguns milhares de arquivos.

Coloque o SKU primeiro, sempre

Nomes de arquivo são ordenados alfabeticamente, então o primeiro campo é o eixo pelo qual a sua pasta se organiza. Faça dele o identificador que nunca muda: o SKU exatamente como ele aparece no seu feed de produtos. Assim, todas as imagens de um produto ficam juntas, não importa quem tenha salvado cada uma.

Calça jeans de lavagem clara dobrada sobre uma superfície branca, com etiqueta pendurada mostrando código de barras impresso, código do produto e tamanho 30.

Datas primeiro (2026-07-14_shoot_final) agrupam por dia de ensaio, o único eixo pelo qual ninguém busca.

Três campos bastam:

  • TS-4410 — o SKU, copiado do feed sem alterar nada
  • MAIN — o que a câmera está olhando
  • white — o que está atrás do produto

Juntando tudo: TS-4410_MAIN_white.png. Qualquer pessoa que leia essa listagem sabe o que é sem abrir o arquivo, e um script separa os campos pelo sublinhado.

Combine os códigos de vista antes de alguém fotografar

O segundo campo só funciona com um vocabulário fixo e escrito. Invente os códigos uma vez e nunca improvise: MAIN para a foto principal, de PT01 a PT08 para as vistas adicionais em uma ordem definida, ALT-back, DETAIL-clasp, SCALE.

Complete os números com zero à esquerda — PT01, não PT1. O Explorador de Arquivos do Windows e o Finder ordenam números de forma natural, mas listagens de terminal, scripts e chaves de armazenamento de objetos ordenam como texto puro, então PT11 cai entre PT1 e PT2 em vez de vir depois deles.

A regra de nome de arquivo da própria Amazon fica nas páginas de ajuda do Seller Central, atrás do login do vendedor, e pode não usar os mesmos separadores daqui. Confira a sintaxe atual na sua conta antes de renomear milhares de arquivos, e mantenha a ideia de fundo — identificador primeiro, código de vista em segundo — em todos os canais de venda (regras de imagem de produto na Amazon).

Nomeie o fundo, não só o produto

Uma foto vira várias entregas: branco puro para o marketplace, cor da marca para um banner, transparente para uma apresentação, sombra projetada para a grade de categoria. Se o nome não diz qual é qual, você acaba publicando a errada.

Rolos de papel de fundo infinito em pé, lado a lado em um estúdio, nas cores branco, creme, bege, rosa, verde, azul-marinho e preto.

Use uma lista curta e fechada para o terceiro campo: raw para o arquivo de câmera intocado, white, brand, cut para transparente, shadow e life para um cenário de estilo de vida. Quando você trocar um fundo no remover.bg — cor sólida, cor personalizada ou uma foto sua —, saiba qual sufixo aquele resultado vai receber antes de começar e renomeie o download na hora.

A extensão também carrega informação. Saída transparente tem que ser PNG ou WebP; um arquivo _cut salvo como JPEG é um defeito, não uma variante (como criar um PNG transparente). Os arquivos brancos de marketplace normalmente são JPEG, e as imagens do site são cada vez mais WebP.

Caracteres que quebram tudo em silêncio

  • Nada de espaços. Eles viram %20 nas URLs, quebram scripts de shell sem aspas e são reescritos silenciosamente pelos formulários de envio.
  • Só ASCII. # e ? encerram a parte do caminho de uma URL e & separa parâmetros de consulta, então qualquer um deles dentro de um nome de arquivo pode truncar ou dividir um link. Caracteres acentuados e outros fora do ASCII ficam fora do conjunto de caracteres permitido em URIs e acabam codificados em porcentagem, virando sequências ilegíveis. Parênteses são válidos em um caminho, mas ainda assim quebram links em markdown e comandos de shell sem aspas.
  • Uma única caixa, maiúscula ou minúscula. Windows e macOS não diferenciam maiúsculas de minúsculas por padrão, então TS-4410 e ts-4410 colidem; servidores Linux e armazenamento de objetos guardam dois arquivos. Padronize tudo em uma só caixa.
  • Um separador por nível. Sublinhado entre campos, hífen dentro de um campo.
  • Nada de palavras de status. final, FINAL2, new, use-this viram mentira em uma semana. Versione substituindo o arquivo, não renomeando.

Mantenha o original de câmera e o recorte separados

Nunca sobrescreva a fonte. TS-4410_MAIN_raw.jpg e TS-4410_MAIN_white.jpg convivem lado a lado, então, quando a cor da marca mudar, você recorta de novo a partir do original em vez de tentar salvar uma exportação já achatada.

Os envios têm limite de 25 MB, e um arquivo grande de câmera pode passar disso. Reduza o tamanho antes no seu próprio editor de fotos — essa cópia reduzida é um terceiro artefato, então dê um nome a ela (TS-4410_MAIN_upload.jpg).

Nomear é o que torna os lotes possíveis

O processamento em lote roda pela API HTTP, então todo arquivo é endereçado pelo nome. Nomes determinísticos dão um trabalho determinístico: o script lê TS-4410_MAIN_raw.jpg, escreve TS-4410_MAIN_cut.png e pode rodar de novo com segurança, porque o caminho de saída é uma função pura da entrada.

Um monitor escuro exibindo código Python com destaque de sintaxe e numeração de linhas, incluindo um laço que percorre itens e imprime cada um deles.

Compare a lista de nomes de saída esperados com o que de fato chegou: a diferença aponta o SKU que falhou. O guia da API para remover fundo de imagens cobre o lado da requisição.

O cartão de regras

Fixe isto no drive compartilhado:

  1. SKU_VIEW_BACKGROUND.ext, nessa ordem.
  2. SKU copiado do feed, caractere por caractere.
  3. Vista tirada da lista combinada. Números com zero à esquerda.
  4. Fundo tirado da lista combinada. A extensão combina com ele.
  5. Uma única forma de caixa, só ASCII, sem espaços, sem datas, sem palavras de status.
  6. Originais guardados como _raw e nunca sobrescritos.

Renomeie à mão os últimos cem arquivos ainda esta semana. Tudo que vier depois disso sai de graça.

Continue lendo