Como criar metafields Shopify e verificar se estão corretos

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

O problema é que muitas lojas criam metafields de forma desordenada. Resultado: tipos inconsistentes, valores inutilizáveis, filtros que deixam de funcionar e perda de tempo para toda a equipa.

1. Criar um metafield limpo na Shopify

1. No admin Shopify, abra Settings e depois Custom data.
2. Escolha o recurso (normalmente 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 sua equipa.

2. A estrutura que evita erros

Respeite esta convenção:

• Namespace estável: por área funcional, ex.: specs, shipping, care.
• Key explícita: ex.: material, wash_temperature, country_of_origin.
• Tipo estrito: não use texto livre se precisar de um número ou uma data.

Exemplo robusto: care.wash_temperature em tipo number_integer.

3. Como saber se os seus metafields estão corretos

Verifique estes 5 pontos num produto de teste:

1. O campo aparece corretamente na ficha do produto no admin.
2. O valor é aceite sem erro de formato.
3. O tipo corresponde ao uso real (ordenação, filtro, visualização).
4. O tema mostra corretamente os dados (se os utilizar no site).
5. Os dados mantêm-se consistentes após importação CSV / app terceira / sincronização.

4. Erros frequentes a evitar

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

5. Mini checklist antes do lançamento

• Nomenclatura validada: namespace + key estáveis.
• Tipo validado em 3 produtos diferentes.
• Visualização validada no tema.
• Nenhuma ambiguidade para a equipa que introduz os dados.