DocumentaçãoGerenciamento de catálogo

Criar e excluir atributos de produto

Última atualização: 31 de julho de 2026

Criado para:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"},{"id":"e8ccd51f-da0d-4e3b-939b-e30d5ebb1ea5"}
  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"}

Você pode criar atributos ao trabalhar em um produto ou na página Product Attributes. As etapas a seguir mostram como criar atributos no menu​Stores.

Etapa 1: Descrever as propriedades básicas do atributo

  1. Na barra lateral Admin, vá para Stores > Attributes>Product.

  2. Clique em Add New Attribute.

    Novas Propriedades de Atributo {width="600" modal="regular"}

  3. Para Default Label, insira um rótulo que identifique o atributo.

  4. Defina Catalog Input Type for Store Owner como o tipo de controle de entrada a ser usado para entrada de dados.

    Se o atributo for usado para um produto configurável, escolha Dropdown. Em seguida, defina Required como Yes.

  5. Se você quiser que uma opção seja selecionada antes que o cliente possa comprar o produto, defina Values Required como Yes.

  6. Para os tipos de entrada Dropdown e Multiple Select, faça o seguinte:

    • Em Manage Options, clique em Add Option.

    • Insira o primeiro valor que você deseja que apareça na lista.

      Você pode inserir um valor para o Administrador e uma tradução do valor para cada exibição de loja. Se você tiver apenas uma visualização de loja, poderá inserir apenas o valor Admin e ele também será usado para a loja.

    • Clique em Add Option e repita a etapa anterior para cada opção que deseja incluir na lista.

    • Selecione Is Default para usar a opção como valor padrão.

    Atributo de produto - gerenciar opções {width="600" modal="regular"}

Etapa 2: descrever as propriedades avançadas (se necessário)

  1. Insira um Attribute Code exclusivo em caracteres minúsculos e sem espaços.

    note
    NOTE
    Não é recomendável usar o valor type no campo Attribute Code. Isso pode causar erros porque o valor type está reservado para uso do sistema.

    Atributo de produto - propriedades avançadas {width="600" modal="regular"}

    As opções disponíveis dependem da configuração Catalog Input Type for Store Owner.

  2. Para indicar onde a hierarquia de armazenamento pode usar o atributo, defina Scope.

  3. Se você quiser impedir qualquer entrada de valor duplicada, defina Unique Value como Yes.

  4. Para tipos de entrada que são valores inseridos, execute um teste de validade de quaisquer dados inseridos em um campo de texto definindo Input Validation for Store Owner como o tipo de dados que o campo deve conter.

    Este campo não está disponível para tipos de entrada com valores selecionados. O teste pode validar qualquer um dos seguintes itens:

    • Decimal Number
    • Integer Number
    • Email
    • URL
    • Letters
    • Letters (a-z, A-Z) or Numbers (0-9)

    Validação de entrada {width="400"}

  5. Para adicionar este atributo à Lista de produtos, defina as seguintes opções como Yes.

    • Adicionar às Opções de Coluna - Inclui o atributo como uma coluna na lista Products.
    • Usar em Opções de Filtro - Adiciona um controle de filtro ao cabeçalho da coluna na lista Products.

Etapa 3: insira o rótulo do campo

  1. No lado esquerdo da navegação, escolha Manage Labels.

  2. Digite um Title para ser usado como rótulo para o campo.

    Se a loja estiver disponível em diferentes idiomas, você poderá inserir um título traduzido para cada exibição.

    Atributo de produto - gerenciar títulos {width="600" modal="regular"}

    note
    NOTE
    Se você planeja usar esse atributo como uma faceta no Live Search, você deve especificar um rótulo específico da loja. Sem ele, o nome do atributo pode não ser exibido corretamente na página de configuração da faceta. Para atualizar a configuração, edite manualmente o rótulo usando a opção de edição na lista facetada do Live Search no Guia do Live Search.

Etapa 4: descrever as propriedades da loja

  1. No lado esquerdo da navegação, escolha Storefront Properties.

    Atributos do produto - propriedades da loja {width="600" modal="regular"}

    As opções disponíveis dependem da configuração Catalog Input Type for Store Owner.

  2. Se o atributo deve estar disponível para pesquisa, defina Use in Search como Yes.

    • Para controlar onde o item aparece nos resultados da pesquisa, defina o valor Search Weight: 1 (peso mais baixo) como 10 (peso mais alto).

    • Defina o Visible in Advanced Search conforme necessário. Saiba mais em Pesquisa avançada.

  3. Para incluir o atributo na Comparação de Produtos, defina Comparable on Storefront como Yes.

  4. Para campos suspensos, de seleção múltipla e de preço, faça o seguinte:

    • Para usar o atributo como um filtro na navegação em camadas, defina Use in Layered Navigation como Yes.

    • Para usar o atributo na navegação em camadas nas páginas de resultados da pesquisa, defina Use in Search Results Layered Navigation como Yes.

    • Para Position, insira um número para indicar a posição relativa do atributo no bloco de navegação em camadas.

  5. Para usar o atributo em regras de preço, defina Use for Promo Rule Conditions como Yes.

  6. Para permitir que o texto seja formatado com HTML, defina Allow HTML Tags on Frontend como Yes.

    Essa configuração disponibiliza o editor do WYSIWYG para o campo.

  7. Para incluir o atributo na página do produto, defina Visible on Catalog Pages on Storefront como Yes.

  8. Conclua as seguintes configurações, se houver suporte no seu tema:

    • Para incluir o atributo nas listagens de produtos, defina Used in Product Listing como Yes.

    • Para usar o atributo como parâmetro de classificação para as listagens de produtos, defina Used for Sorting in Product Listing como Yes.

  9. Quando terminar, clique em Save Attribute.

Etapa 5: Atribuir o atributo criado ao conjunto de atributos

Para que um atributo fique visível na página de criação do produto, adicione-o a um conjunto de atributos específico.

  1. Depois de concluir as etapas anteriores, vá para Stores > Attributes>Attribute Set.

  2. Selecione o conjunto de atributos necessário na lista e abra-o no modo de edição.

  3. Arraste o atributo criado da lista Unassigned Attributes para a pasta apropriada na coluna Grupos.

  4. Quando terminar, clique em Save.

Atributos para produtos configuráveis

Qualquer atributo usado como uma lista suspensa de opções de um produto configurável deve ter as seguintes propriedades:

Propriedade
Valor
Tipo de Entrada de Catálogo para o Proprietário da Loja
Lista suspensa
Escopo
Global

Excluir um atributo

Quando um atributo é excluído, ele é removido de todos os produtos e conjuntos de atributos relacionados. Os atributos do sistema fazem parte da funcionalidade principal do armazenamento e não podem ser excluídos.

Antes de excluir um atributo, verifique se nenhum produto do catálogo o usa no momento. Uma maneira fácil de determinar se um atributo está em uso é usar a ferramenta Export para verificar a lista de Atributos de Entidade do produto. Se a lista não incluir o atributo, nenhum produto no catálogo o usará.

Para excluir um atributo:

  1. Na barra lateral Admin, vá para Stores > Attributes>Product.

  2. Localize o atributo na lista e abra-o no modo de edição.

  3. Clique em Delete Attribute.

    Excluir atributo {width="600" modal="regular"}

  4. Quando for solicitada a confirmação, clique em OK.

recommendation-more-help
commerce-admin-help-catalog