Adicionar Metafields aos Produtos Shopify

Adicionar ou atualizar metafields para muitos produtos de uma vez pode ser demorado se feito manualmente. DataEase facilita: exporte seus produtos, edite os valores dos metafields no Excel ou CSV usando pares namespace:key, e importe-os de volta para o Shopify — tudo com validação segura de tipos.

🎯 Objetivo

Adicionar ou atualizar metafields de produtos em massa usando CSV/Excel e DataEase. Use pares namespace:key limpos com valores de tipo seguro.

📋 Instruções Passo a Passo

1. Exportar Produtos

No DataEase, vá para Nova Exportação → Produtos. Inclua no mínimo:

• id
• handle

Opcionalmente, adicione metafields existentes para revisar os dados atuais.

Isso lhe dará um arquivo com todos os seus produtos prontos para edição.

2. Escolher Como Editar Metafields

O DataEase suporta dois métodos para editar metafields:

Colunas dinâmicas (recomendado): Adicione uma coluna por chave, nomeada metafield: {namespace} / {key} (por exemplo, metafield: my_fields / material). Insira o valor diretamente na célula.

Coluna única “metafields”: Forneça várias entradas em uma célula como namespace:key = value; namespace2:key2 = value2 (separadas por ponto e vírgula).

3. Editar o Arquivo

Abra o arquivo exportado no Excel ou Google Sheets. Para cada linha que você deseja alterar:

1. Defina command = UPDATE
2. Preencha seus valores de metafield usando o formato apropriado:
   • Strings: texto simples (por exemplo, Organic Cotton)
   • Números: formatos numéricos (por exemplo, 42, 19.95)
   • Booleanos: TRUE / FALSE
   • Data/Hora: formato ISO-8601 (por exemplo, 2025-11-05T10:00:00+01:00)
   • JSON: JSON válido (por exemplo, {"color":"red","size":"m"})

Quando terminar, salve o arquivo como .xlsx ou .csv.

4. Importar e Validar

1. No DataEase, inicie Nova Importação
2. Carregue seu arquivo editado
3. Mapeie as colunas (ID do Produto preferencialmente)
4. Execute a Validação

Abra o relatório de validação e corrija quaisquer problemas de tipo/formato sinalizados no Status de Validação.

5. Executar a Importação

Após a validação ser aprovada, clique em Executar Importação para aplicar seus metafields ao Shopify.

Uma vez concluído, verifique os produtos no admin do Shopify para confirmar se tudo está correto.

📝 Notas Importantes

• Limpar um metafield: Deixe a célula da coluna dinâmica vazia para essa chave em UPDATE para removê-la
• Tipos: O validador verifica os tipos de metafield do Shopify (string, number, boolean, date_time, json, etc.). Use formatos apropriados para passar na validação
• Consistência: Mantenha namespaces e chaves consistentes (my_fields.material, sem misturar maiúsculas/minúsculas/espaçamentos)
• Metafields de variantes: Siga a mesma abordagem em exportações de nível de variante (veja o guia de Variants) usando o ID da Variante e as colunas de metafield correspondentes

💡 Exemplos Mínimos de CSV

Colunas dinâmicas (recomendado):

id,command,metafield: my_fields / material,metafield: my_fields / season
gid://shopify/Product/123,UPDATE,Organic Cotton,Summer 2025

Coluna única “metafields”:

id,command,metafields
gid://shopify/Product/456,UPDATE,"my_fields:material = Organic Cotton; my_fields:season = Summer 2025"

Limpar um metafield (coluna dinâmica deixada em branco):

id,command,metafield: my_fields / material
gid://shopify/Product/789,UPDATE,

🎉 É isso!

Seus metafields agora estão adicionados ou atualizados em massa.
Se você encontrar algum problema ou tiver dúvidas, sinta-se à vontade para entrar em contato com nossa equipe de suporte.