Quando uma loja decide investir em busca inteligente, recomendação personalizada ou preparação para agentes de IA, a conversa costuma começar pela ferramenta. Qual motor de busca, qual solução de recomendação, qual protocolo. Em quase todos os projetos que acompanhamos, a conversa deveria começar um passo antes, num lugar menos glamoroso: os atributos de produto no Magento.
Atributo é a informação estruturada que descreve o produto: voltagem, cor, material, princípio ativo, compatibilidade, tamanho, peso. É ele que alimenta filtros, comparações, especificações, feeds de marketplace, marcação estruturada e, agora, as respostas de assistentes de IA. Em setembro, mostramos que a lacuna real do agentic commerce é de dado. Este artigo desce ao nível prático: como modelar e governar atributos no Magento para que eles sirvam a todos esses usos ao mesmo tempo.
Principais pontos do artigo
- Atributos estruturados são a base comum de filtros, busca, feeds, marcação estruturada e leitura por IA.
- No Magento, cada atributo tem propriedades que definem onde ele aparece e como é usado; configurações erradas desperdiçam dados bons.
- Atributos de lista, com valores controlados, valem mais do que texto livre para qualquer uso automatizado.
- Conjuntos de atributos por família de produto evitam catálogos genéricos e incompletos.
- Sem um responsável pela qualidade do catálogo, o trabalho de estruturação se perde em poucos meses.

Por que o atributo é a base de tudo
Pense em uma pergunta comum a um assistente de IA: “qual furadeira sem fio de 18 volts com duas baterias custa menos de seiscentos reais?”. Para responder, o sistema precisa encontrar produtos em que “tipo de alimentação” seja bateria, “voltagem” seja 18V, “quantidade de baterias” seja 2 e o preço esteja abaixo do valor. Se essas informações estiverem só na descrição, misturadas em um parágrafo, a chance de a loja aparecer na resposta cai muito.
A mesma lógica vale para a busca interna da loja, para os filtros da categoria, para o comparador de produtos e para os feeds enviados ao Google e aos marketplaces. Um atributo bem modelado é escrito uma vez e reaproveitado em todos esses lugares. Um atributo mal modelado gera retrabalho em cada canal.
Como o Magento organiza os atributos
O Magento trabalha com dois conceitos que precisam estar claros para quem cuida do catálogo.
Conjuntos de atributos
Cada produto pertence a um conjunto de atributos, que define quais campos ele tem. Uma loja de materiais elétricos pode ter conjuntos para fios e cabos, disjuntores, luminárias e ferramentas, cada um com os atributos que fazem sentido para aquela família. Lojas que usam um único conjunto genérico para tudo acabam com dezenas de campos vazios ou, pior, com informações importantes empurradas para a descrição.
Propriedades de cada atributo
Cada atributo tem configurações que determinam como ele é usado na vitrine. Entre as mais importantes estão: se é usado na navegação em camadas, ou seja, nos filtros; se é pesquisável e qual o peso na busca; se é visível nas páginas de catálogo da vitrine, o que o faz aparecer no bloco de informações adicionais; se é comparável; se é usado na listagem e na ordenação de produtos; e se pode ser usado em condições de regras promocionais.
É comum encontrarmos lojas com dados excelentes que não aparecem em lugar nenhum porque o atributo foi criado sem essas propriedades ativadas. O dado existe no banco, mas a vitrine, a busca e a página de produto não o usam.
Cinco decisões de modelagem que fazem diferença
1. Prefira listas a texto livre
Atributos do tipo lista suspensa ou seleção múltipla têm valores controlados. “Bivolt”, “127V” e “220V” como opções fixas são muito mais úteis do que um campo de texto em que cada cadastro escreve “bivolt”, “Bi-volt”, “110/220” ou “127-220V”. Filtros, feeds e sistemas de IA dependem de valores consistentes.
2. Padronize unidades
Decida se peso é em gramas ou quilos, se dimensões são em centímetros ou milímetros, e mantenha a unidade no nome ou na configuração do atributo, não no valor. “Peso (kg)” com o valor “1,2” é melhor do que “Peso” com o valor “1,2 kg” em alguns produtos e “1200g” em outros.
3. Separe o que é filtro do que é especificação
Nem todo atributo precisa virar filtro. Filtros demais poluem a navegação. Uma boa prática é escolher, para cada categoria, os cinco a oito atributos que realmente orientam a decisão de compra e deixar os demais como especificação visível na página de produto.
4. Use identificadores de mercado
Marca, código de barras e referência do fabricante são atributos que parecem burocráticos, mas são decisivos para feeds e para a marcação estruturada. Eles permitem que sistemas externos reconheçam que o produto da sua loja é o mesmo que aparece em outras fontes.
5. Nomeie para o cliente, não para o ERP
Muitos catálogos herdam do ERP nomes como “COD_TENSAO” ou “DESC_COMPL_2”. O rótulo exibido na vitrine precisa ser a palavra que o cliente usa. O código interno pode continuar existindo para a integração, mas não deveria aparecer para quem compra.
Como diagnosticar o estado do seu catálogo
Um diagnóstico inicial pode ser feito em poucos dias, sem ferramenta especial:
- Exporte os produtos das três categorias de maior receita e calcule o percentual de preenchimento de cada atributo.
- Liste os atributos de texto livre que deveriam ser listas e conte quantas variações de escrita existem para o mesmo valor.
- Confira as propriedades dos atributos mais importantes: estão na navegação, na busca e na página de produto?
- Compare os filtros disponíveis nas categorias com as perguntas que os clientes fazem ao atendimento.
- Verifique se marca e código de barras estão preenchidos nos produtos enviados a feeds e marketplaces.
O resultado costuma ser revelador. Em lojas com milhares de produtos, é comum descobrir que atributos críticos têm menos de metade de preenchimento, e que uma parte dos valores preenchidos não segue padrão.
Governança: o trabalho que não acaba
A estruturação do catálogo tem um inimigo silencioso: o cadastro do dia seguinte. Uma loja pode fazer um grande saneamento e, seis meses depois, estar de volta ao ponto inicial, porque os novos produtos entram com os mesmos vícios.
Por isso recomendamos três medidas permanentes. Primeiro, um responsável nomeado pela qualidade do catálogo, com autoridade para recusar cadastros incompletos. Segundo, atributos obrigatórios por conjunto, configurados no próprio Magento para impedir que produtos sem informação crítica sejam salvos. Terceiro, um indicador simples de preenchimento, acompanhado mensalmente junto com os indicadores de venda.
Esse trabalho conversa diretamente com a legibilidade da vitrine. No artigo sobre como a página de produto no Magento pode ser lida pela IA, mostramos que o bloco de especificações montado a partir dos atributos é um dos conteúdos mais valiosos para leitura por máquina. Atributo bem modelado e página bem renderizada são duas metades da mesma solução.
Como a Trezo trata esse cenário
A Trezo atua com lojas Magento em setores como eletrônicos, beleza, farma, alimentos e autopeças, cada um com sua própria lógica de atributos. Essa visão multissetorial nos ajuda a propor modelos de catálogo que funcionam para filtros, busca, feeds e IA ao mesmo tempo, e a desenhar a governança que mantém o catálogo saudável depois do projeto. A operação roda em infraestrutura gerenciada na AWS e segue processos auditados pela certificação ISO 27001.
Se a sua loja está avaliando busca inteligente ou preparação para IA, comece pelo catálogo. Fale com nossos especialistas.
Perguntas frequentes
Sim. A estrutura de atributos, conjuntos de atributos e propriedades de uso na vitrine é a mesma nas duas edições. O Adobe Commerce acrescenta recursos de gestão e integração com serviços da Adobe, mas a modelagem do catálogo segue os mesmos princípios.
Em geral, de cinco a oito atributos que realmente orientam a decisão de compra naquela categoria. Os demais podem aparecer como especificação na página de produto, sem poluir a navegação.
Pode valer, como apoio para extrair informações de descrições e fichas técnicas existentes. Mas o resultado precisa de revisão humana e de valores controlados, porque atributos errados são piores do que atributos vazios: eles levam o cliente e os assistentes a conclusões incorretas.


