Convenção de nomes para imagens de produto

A cotação que você mandou semana passada foi montada com uma foto de 2024. O comprador cotou com a base antiga, você embarcou a nova, e a discussão que veio depois não era de engenharia nem de preço: era sobre qual arquivo era a verdade. O nome daquela foto não deu a resposta para nenhum dos dois.

Uma convenção de nomes para imagens de produto é um padrão fixo e ordenável por máquina aplicado a toda foto de todo SKU, de forma que um arquivo seja identificado — produto, vista, versão, data — sem abrir, e duas pessoas em dois países consigam dizer qual é o vigente. Não é organização estética. É a prova mais barata que você tem de que a foto aprovada é a foto que saiu.

A seguir: o padrão que aguenta cinco anos de catálogo, os tokens que realmente carregam informação, os três pontos em que o nome quebra e a ordem para renomear uma biblioteca existente sem derrubar anúncios ativos.

O que uma convenção de nomes para imagens de produto precisa resolver

Um nome de arquivo tem três funções, e a maioria dos fornecedores projeta só a primeira.

A terceira função é a que custa dinheiro. No instante em que você não aponta o arquivo aprovado, o "não é o acabamento que combinamos" do comprador fica quase sem réplica, mesmo que o acabamento esteja exatamente certo. Numa pasta em que o arquivo mais novo se chama (1), ninguém reconstrói o que foi enviado em março.

Os cinco tokens, nesta ordem

A ordem importa mais que o vocabulário. Com a sequência fixa, uma ordenação alfabética simples produz uma lista utilizável: um SKU agrupado, vistas em ordem fixa, versão mais nova no fim.

O nome completo fica SM-CB-1200_front_v03_2026-10-29.jpg: 38 caracteres, sem espaço, sem símbolo que precise de escape, e ordena certo no Finder, no Explorer e no Drive.

O SKU vem primeiro porque o arquivo do comprador é indexado por SKU: é o número da ordem de compra. Um nome que começa pelo produto (walnut-cabinet-1200mm-2.jpg) espalha um SKU pelo alfabeto inteiro no momento em que você vende o mesmo armário em dois acabamentos. A data é um token separado porque a versão diz o que mudou e a data diz quando o comprador pôde ver; se a reclamação chega seis meses depois, o que resolve é a data.

Grave esta frase: nome de arquivo não é etiqueta, é o único registro de qual foto você aprovou.

O token de vista: lista fechada, não adjetivo

Quando a vista é escrita livre, a convenção morre. Feche a lista nos valores que você realmente publica.

Nove valores cobrem quase toda consulta B2B. Se aparecer um décimo, escreva na lista antes de usar: convenção que vive na cabeça de uma pessoa não é convenção.

dim e scale se confundem o tempo todo. dim é o desenho medido; scale é a foto com referência. Quem verifica se passa pela porta precisa de scale; quem preenche a cotação precisa de dim. Quando os dois vivem sob o mesmo nome, o errado é o que é encaminhado.

Versão e data não são o mesmo campo

A versão responde "é o mesmo produto de antes?"; a data responde "desde quando este arquivo é o oficial?". Elas se separam no momento em que a foto é refeita sem mudar o produto — fundo mais limpo, luz melhor no acabamento — e é exatamente o caso que gera disputa, porque o produto parece um pouco diferente e o comprador supõe que a especificação mudou.

Três regras, escritas onde a equipe vê:

• A versão sobe só quando muda o produto, o acabamento ou a medida. Uma reexecução que só muda a luz mantém a versão e recebe a data nova; se precisar guardar as duas, acrescente -res: SM-CB-1200_front_v03_2026-10-29-res.jpg.
• O arquivo aprovado mantém o nome para sempre. Ao gerar um novo, o anterior vai para archive/ com o nome intacto: nunca renomeado para old, nunca sobrescrito.
• Nada é enviado de archive/. Se o comprador pede a foto da temporada passada, ela sai renomeada com a própria data, então o arquivo continua se identificando.

Essa última regra é a razão de existir do token de versão: arquivo sobrescrito com o mesmo nome é inverificável, você não prova o que enviou nem o comprador o que recebeu. A mesma disciplina aparece numa checklist de mudança de especificação de produto, em que a versão precisa chegar a todos os documentos ao mesmo tempo.

Um exemplo prático: uma consulta, seis arquivos

Um comprador pede o armário de nogueira de 1.200 mm, a versão de 900 mm e a caixa do embalagem plana. A resposta são seis arquivos, escolhidos só pelo nome:

Duas coisas saltam da tabela que uma pasta de 40 fotos soltas não entrega. Os dois modelos foram fotografados com duas semanas de diferença, e as datas tornam isso visível — útil quando perguntam se o de 900 mm recebeu a dobradiça nova. E cada arquivo declara sua função, então engenheiro, despachante e showroom pegam o que precisam sem um segundo e-mail.

É o mesmo princípio de uma ficha técnica de um único SKU: um SKU, uma página, um trabalho. A convenção de nomes é esse princípio aplicado aos arquivos que montam a página, e é o que torna reproduzível em todo o catálogo o caso de anotação de anúncios de mobiliário. Também é o pré-requisito para reaproveitar imagens de produto entre plataformas sem adivinhar a qual canal cada ativo pertence.

Os três pontos em que o nome quebra

Nenhum é opinião de estilo. Cada um parte a biblioteca em duas sem avisar.

1. Comprimento do caminho: 260 caracteres no Windows

O Windows limita o caminho completo a 260 caracteres, com 255 para um nome. Um arquivo que abre bem numa pasta de teste fica impossível de abrir três pastas adentro do diretório de downloads do cliente. Nomes descritivos longos mais pastas profundas são o jeito de transformar um bom arquivo em "arquivo não encontrado".

Mantenha o nome abaixo de 60 caracteres e o caminho abaixo de 150, e o problema não acontece. É também o motivo prático de não colar o título do produto: é longo, duplica o SKU e é a primeira coisa a ser cortada.

2. Caracteres reservados, espaços e maiúsculas

O Windows proíbe < > : " / \ | ? * e reserva nomes como CON, PRN, AUX, NUL. Na URL o resto se estraga: o espaço vira %20, o # corta o link no fragmento e o ? transforma o resto em query string. O arquivo abre no seu notebook e devolve 404 num aplicativo de mensagem.

Maiúsculas são a armadilha silenciosa: Windows e macOS comparam nomes sem diferenciar maiúsculas por padrão, então SM-CB-1200_front.jpg e sm-cb-1200_front.jpg são um arquivo no Mac e dois objetos no servidor Linux. Suba os dois e você não consegue dizer qual o anúncio mostra.

Use só minúsculas, dígitos, hífen e ponto. O hífen atravessa qualquer cliente, gateway e parser de URL; o underscore e o espaço não.

3. Acentos e normalização Unicode

Dois caracteres podem parecer idênticos e ser bytes diferentes. O "é" pode ser um caractere precomposto ou um e mais acento combinante; o macOS compara nomes sem diferenciar normalização, servidores Linux e armazenamento em nuvem normalmente diferenciam. Copie uma pasta do Mac para um servidor e um nome acentuado pode virar dois arquivos — ou pior, um sobrescrever o outro.

Se o catálogo tem acentos ou caracteres chineses, mantenha o nome em ASCII e ponha o nome local nos dados do produto, para que o mesmo arquivo funcione em qualquer máquina da cadeia.

Há uma quarta quebra que não é sobre o nome: o CDN entrega o arquivo pela URL, e caches continuam servindo a imagem antiga depois que você substitui o arquivo no mesmo caminho. Um token de versão resolve isso de graça: versão nova é URL nova, não há nada obsoleto para invalidar, e a URL ainda serve de trilha de auditoria.

Renomear a biblioteca que você já tem

Aplicar uma convenção de nomes para imagens de produto a uma biblioteca existente é o que todo mundo adia. Não comece pelos 4.000 arquivos; comece pelos que estão vivos.

1. Exporte a lista de SKU do sistema de cotação, não da pasta de fotos: a pasta não tem os SKU ativos e tem os descontinuados.
2. Marque os SKU que apareceram em anúncio, catálogo ou cotação nos últimos 12 meses — normalmente 10% a 20% da biblioteca.
3. Renomeie só esses, começando pelo arquivo aprovado mais recente, e mova as versões antigas para archive/ sem mudar o nome.
4. Atualize as referências no mesmo dia: arquivo renomeado é URL nova, então o que ainda aponta para o caminho antigo quebra à vista, não em silêncio.
5. Deixe a cauda longa para quando for necessária. Regra aplicada em 200 SKU vivos vale mais que convenção perfeita aplicada a nada.

O modo de falha da renomeação geral é conhecido: alguém renomeia uma pasta numa sexta, o anúncio fica em branco no fim de semana e a convenção é descartada como "aquilo que quebrou o site". Ordene o trabalho pelo que está publicado e a migração custa uma hora, não uma semana.

Checklist antes de enviar

• O nome começa pelo SKU, idêntico ao impresso na caixa e na cotação
• O valor de vista veio da lista fechada, não da memória
• A versão subiu só por mudança de produto, acabamento ou medida
• A data é a de aprovação, não a do ensaio
• Só hífen, minúsculas, sem espaço, sem acento, sem # ou ?
• O nome cabe em 60 caracteres e ainda abre três pastas adentro
• A versão anterior está em archive/ com o nome original intacto
• Cada anúncio ativo, página de catálogo e cotação enviada aponta para o arquivo vigente
• O arquivo dim e o scale não foram trocados

Perguntas frequentes

Qual é uma boa convenção de nomes para imagens de produto?

SKU_vista_versão_data.extensão, tudo em minúsculas e nessa ordem fixa. Carrega os quatro fatos de que um colega ou comprador precisa — qual produto, qual vista, qual revisão, aprovado quando — e ordena certo em qualquer gerenciador de arquivos, sem banco de dados.

O SKU ou o nome do produto deve vir primeiro no nome do arquivo?

O SKU, sempre. Ele aparece na ordem de compra, na caixa e na fatura, então é o número ao qual o arquivo do comprador está indexado. Nomes comerciais variam por mercado, acabamento e idioma, e uma biblioteca ordenada por nome divide um SKU entre as duas pontas do alfabeto assim que existe um segundo acabamento.

Que caracteres evitar nos nomes de arquivo de imagem?

Evite espaço, #, ?, %, &, <, >, :, ", /, \, |, * e acentos ou caracteres não latinos. O Windows proíbe vários deles, o espaço vira %20 na URL e o # corta o link sem avisar. O hífen é o separador mais seguro.

Como nomear fotos de vistas diferentes do mesmo produto?

Dê a cada vista um token fixo da lista fechada — front, main, dim, detail, scale, pack, assembled, packed, break — e não invente palavra nova para um pedido pontual. É essa lista que faz a ordenação alfabética funcionar como folha de contatos: todas as vistas de um SKU juntas, sempre na mesma ordem.

Onde entra o número de versão quando a foto muda?

Logo depois do token de vista e antes da data; sobe só quando muda produto, acabamento ou medida, não quando a luz melhora. Reexecuções que só mudam a exposição mantêm a versão e recebem data nova. Quando o arquivo precisa mudar e a versão não pode andar, acrescente um sufixo como -res para os dois arquivos continuarem distinguíveis para sempre.

Se a versão salta porque uma medida mudou, renomear não resolve: o desenho antigo já carrega um número que não corresponde ao produto. É aí que um fluxo de trabalho se paga — medir uma vez, travar o valor nas bordas reais do produto na foto e reexportar no tamanho que cada canal exige, para a versão nova sair da mesma fonte em vez de ser redesenhada a olho. Uma cena gerada pode melhorar a apresentação; num arquivo dim só entra valor medido.

Fontes e referências

• Microsoft Learn — Naming Files, Paths, and Namespaces (caracteres reservados, nomes de dispositivo reservados, limite de 260 caracteres)
• RFC 3339 — Date and Time on the Internet: Timestamps (o formato YYYY-MM-DD derivado da ISO 8601)
• GS1 — GTIN, chaves de identificação de itens comerciais
• Unicode Standard Annex #15 — Formas de normalização Unicode (caracteres pré-compostos e combinantes)
• RFC 3986 — URI: caracteres reservados e codificação percentual
• AWS — Invalidar arquivos no CloudFront (objetos em cache são indexados pelo caminho da requisição)