# Chaves de metadados

## O que são metadados de produto?[​](#what-is-product-meta-data "Link direto para O que são metadados de produto?")

Todo produto WooCommerce pode ter campos extras além do nome e do preço — como um tamanho, uma mensagem de gravação, um código de fornecedor ou dados adicionados por outros plugins. O WooCommerce armazena isso como **metadados**: cada entrada tem uma **chave** (o nome do campo, por exemplo, `engraving`) e um **valor** (por exemplo, `"Happy Birthday"`).

## O que a configuração Chaves de metadados faz[​](#what-the-meta-data-keys-setting-does "Link direto para O que a configuração Chaves de metadados faz")

Por padrão, ao adicionar um produto ao carrinho, apenas os detalhes padrão dele são copiados. A configuração **Chaves de metadados** (Painel de produtos → Configurações) permite escolher quais chaves de metadados do produto devem ser **copiadas para o item de linha do carrinho** — e, portanto, salvas no pedido.

Por exemplo, adicionar `engraving` à lista significa que, sempre que você adiciona um produto gravável ao carrinho, o valor de gravação dele acompanha o produto até o pedido.

## Escolha das chaves[​](#choosing-keys "Link direto para Escolha das chaves")

Comece a digitar no campo Chaves de metadados:

* As **Sugestões** são as chaves de metadados encontradas nos produtos já sincronizados com este dispositivo.
* Se a chave necessária não estiver listada (por exemplo, se ela existir apenas em produtos ainda não sincronizados), digite o nome exato da chave e escolha **Adicionar "…" como chave personalizada**.
* As chaves selecionadas aparecem como marcadores; remova uma tocando no ✕ correspondente.

As chaves escolhidas são salvas com as outras configurações do painel e se aplicam tanto às visualizações em tabela quanto em grade (blocos).

## Dicas[​](#tips "Link direto para Dicas")

* As chaves de metadados diferenciam maiúsculas de minúsculas e devem corresponder exatamente à chave armazenada no produto.
* As chaves que começam com um sublinhado (por exemplo, `_size`) são metadados "ocultos"/internos do WooCommerce Elas ainda funcionam aqui se é onde seus dados ficam.