Como criar metafields na Shopify e verificar se estão corretos

Um metafield na Shopify serve para armazenar informações que não existem nos campos padrão: composição, instruções de cuidado, país de fabricação, dimensões técnicas, prazo de entrega, entre outras.

O problema é que muitas lojas criam metafields sem critério. Resultado: tipos inconsistentes, valores inutilizáveis, filtros quebrados e perda de tempo para toda a equipe.

1. Criar um metafield organizado na Shopify

1. No admin da Shopify, abra Settings e depois Custom data.
2. Escolha o recurso (geralmente Products).
3. Clique em Add definition.
4. Defina um nome claro (ex: Composição do material).
5. Escolha um tipo adequado (texto, número, data, booleano, lista, etc.).
6. Adicione uma descrição para orientar a equipe.

2. A estrutura que evita erros

Siga esta convenção:

• Namespace estável: organizado por domínio funcional, ex: specs, shipping, care.
• Key explícita: ex: material, wash_temperature, country_of_origin.
• Tipo rígido: não use texto livre se o que você precisa é de um número ou de uma data.

Exemplo robusto: care.wash_temperature no tipo number_integer.

3. Como saber se seus metafields estão corretos

Verifique estes 5 pontos em um produto de teste:

1. O campo aparece corretamente na ficha do produto no admin.
2. O valor é aceito sem erro de formato.
3. O tipo corresponde ao uso real (ordenação, filtro, exibição).
4. O tema exibe o dado corretamente (se você o usa na loja).
5. O dado permanece consistente após importação CSV, app terceiro ou sincronização.

4. Erros comuns a evitar

• Misturar vários usos no mesmo campo (ex: material + instruções de cuidado).
• Usar keys diferentes para a mesma informação entre produtos.
• Escolher o tipo texto quando o tipo lista ou número é necessário.
• Criar metafields sem descrição interna para a equipe.

5. Mini checklist antes de publicar

• Nomenclatura validada: namespace + key estáveis.
• Tipo validado em 3 produtos diferentes.
• Exibição validada no tema.
• Nenhuma ambiguidade para quem insere os dados.