Sincronizar metafields
Visão geral da IA
Aprenda a sincronizar metafields de produto e de variante de uma Source store para uma Destination store no Tipo Sync. Você ativa o compartilhamento de metafields na Source store e a sincronização de metafields na Destination store, e depois escolhe quais metafields sincronizar usando namespace.key. Os tipos de dados devem ser exatamente iguais nas duas lojas.
Ver maisVer menos
- Tipos de referência e MetaObjects não são compatíveis; os tipos de dados dos metafields devem ser iguais nas duas lojas.
- Na Source store, abra Settings, ative Share Metafields, escolha o recurso Product ou Variant e adicione as definições como namespace.key.
- Na Destination store, abra Stores, abra os detalhes da conexão, ative Metafields sync e selecione os recursos.
- Clique em Save; as definições ausentes são criadas automaticamente na Destination store.
- Um valor vazio na Source nunca substitui um valor existente na Destination.
Resumo gerado por IA. Ele pode conter erros, então confira o guia completo abaixo.
Este guia explica como sincronizar metafields da sua Source store para a sua Destination store no app Tipo.
ℹ️ O que são metafields?
Seção intitulada “ℹ️ O que são metafields?”- Metafields de produto
- Metafields de variante (se você ativar essa opção)
O app Tipo pode sincronizar metafields de:
- material, tabela de medidas, especificações
- selos personalizados (por exemplo, “best_seller”)
- detalhes extras de produtos usados por temas ou apps
Metafields são campos personalizados no Shopify usados para armazenar dados extras de produtos, como:
✅ Tipos de metafield suportados
Seção intitulada “✅ Tipos de metafield suportados”- Texto de várias linhas
- Rich text
- Inteiro
- Decimal
- Data e hora
- Data
- Dimensão
- Volume
- Peso
- Verdadeiro ou falso
- Avaliação
- URL
- Dinheiro
- Link
- JSON
🚫 Ainda não suportados:
Tipos de referência (por exemplo, referência de produto, referência de coleção) não são suportados no momento.
🛠️ Etapa 1: configurar os metafields na Source Store
Seção intitulada “🛠️ Etapa 1: configurar os metafields na Source Store”- Abra o app > clique em Settings > ative Share Metafields
- Escolha o recurso que você quer compartilhar:
- Product resource – compartilhar metafields de produto.
- Variant resource – compartilhar metafields de variante.
- Adicione definições de metafield específicas para limitar quais metafields são compartilhados.
-
Clique no ícone Browse metafields, ou
-
Digite a definição do metafield no formato:
namespace.key
-
Por exemplo:
``` custom.materialseo.titlespecifications.weight ```4. Click Save to update the changes


🛠️ Etapa 2: configurar os metafields na Destination Store
Seção intitulada “🛠️ Etapa 2: configurar os metafields na Destination Store”- Abra o app > clique em Stores > clique na URL da loja de origem para abrir os detalhes da conexão

- Ative Metafields sync
- Escolha o que sincronizar
Em Allow data, selecione um ou ambos:
- Product Resource → sincroniza metafields de produto
- Variant Resource → sincroniza metafields de variante
- Clique no ícone de pesquisa à direita para ver todos os metafields suportados > clique no botão Select valid metafield to sync


- Clique em Save para atualizar as alterações
🔄 O que acontece durante a sincronização
Seção intitulada “ 🔄 O que acontece durante a sincronização”1) Se a Destination store não tiver a definição do metafield
Seção intitulada “1) Se a Destination store não tiver a definição do metafield”O app criará automaticamente a definição do metafield na Destination store (quando necessário).
Depois de criado, os valores sincronizados do metafield aparecerão no produto/variante da Destination store.
2) Se os metafields existirem, mas não estiverem “estruturados” (metafields não estruturados)
Seção intitulada “2) Se os metafields existirem, mas não estiverem “estruturados” (metafields não estruturados)”Em alguns casos, os metafields podem ser sincronizados mesmo que não tenham sido totalmente definidos/estruturados na Destination store.
Para revisá-los no Shopify Admin:
- abra as Settings → Metafields and metaobjects da loja
- Escolha Product (ou Variant)
- Abra View unstructured metafields
💡 Dica: você pode definir/estruturar esses metafields manualmente depois para manter os dados da sua loja limpos e consistentes.

3) Se a Source store não tiver valor, a Destination não será sobrescrita
Seção intitulada “3) Se a Source store não tiver valor, a Destination não será sobrescrita”Se um metafield existir na Destination, mas o valor da Source estiver vazio, o Tipo Sync não sobrescreverá o valor da Destination.
4) Os tipos de dados devem coincidir (muito importante)
Seção intitulada “4) Os tipos de dados devem coincidir (muito importante)”Os tipos de dados dos metafields devem coincidir exatamente entre a Source e a Destination.
Exemplos de incompatibilidade de tipos de dados:
single_line_text_fieldvsmulti_line_text_fieldnumber_integervsnumber_decimalproduct_referencevstext
⚠️ Se os tipos de dados não coincidirem, a sincronização pode falhar ou ignorar esse metafield.
📌 Exemplo: sincronizando um metafield de produto – “Material”
Seção intitulada “📌 Exemplo: sincronizando um metafield de produto – “Material””Você quer sincronizar um metafield personalizado de produto chamado Material (por exemplo, “Algodão”, “Couro”, “Lã”) da sua Source Store para a sua Destination Store usando nosso app.
Etapa 1: definir o metafield no Shopify
Seção intitulada “Etapa 1: definir o metafield no Shopify”Na sua Source Store:
- Acesse Shopify Admin > abra as Settings > Metafields and metaobjects da loja > escolha Product (ou Variant)
- Clique em Add definition (se ainda não estiver criada) > preencha a definição do metafield:
- Name: Material
- Namespace:
custom - Key:
material - Type: Single line text
=> Isso gera a chave completa do metafield: custom.material
Repita esta etapa na sua Destination Store (deve coincidir com a mesma chave e o mesmo tipo).

Etapa 2: adicionar dados de metafield aos produtos
Seção intitulada “Etapa 2: adicionar dados de metafield aos produtos”Na sua Source Store, acesse um produto, role até Metafields > em Material, digite: Cotton
Este produto agora tem o metafield custom.material = "Cotton".

Etapa 3: configurar a sincronização no app Tipo
Seção intitulada “Etapa 3: configurar a sincronização no app Tipo ”- Abra nosso app na Destination Store > acesse Connect Configuration > Metafield Sync
- Escolha Specific Metafields > digite a chave do metafield exatamente como:
custom.material

Resultado
- Nosso app encontrará
custom.materialna Source Store - Se ele não existir no produto da Destination, o app o criará
=> Resultado:custom.material = "Cotton"nas duas lojas - Se ele existir na Destination, mas estiver vazio na Source, não substituímos o valor
❓Perguntas frequentes
Seção intitulada “❓Perguntas frequentes”P1: como definir namespace.key na sua loja?
Seção intitulada “P1: como definir namespace.key na sua loja?”Para sincronizar um metafield específico, você precisará digitar a chave da definição do metafield neste formato: namespace.key (por exemplo: custom.color).
Veja como encontrá-la no seu admin do Shopify:
- Acesse seu Shopify Admin > vá em Settings > Custom Data > Products
- Clique no metafield que você quer sincronizar
→ Você verá os valores Namespace e Key - Combine-os neste formato:
namespace.key
→ Exemplo:custom.description
P2: por que meus metafields não estão sincronizando?
Seção intitulada “P2: por que meus metafields não estão sincronizando?”Se seus metafields não estiverem sincronizando corretamente, pode ser por um dos seguintes motivos:
- A sincronização de metafields não está ativada
Certifique-se de que a sincronização de metafields esteja ativada nas duas lojas:- Ative Share Metafields na Source Store.
- Ative Receive Metafields na Destination Store.

- A chave da definição do metafield não foi adicionada
Além de ativar a sincronização de metafields, você também precisa adicionar a chave da definição do metafield (namespace.key) que deseja sincronizar.
- Acesse Settings → Share Metafields
- Certifique-se de que Enable esteja marcado
- Em Allow data, adicione a definição do metafield neste formato:
namespace.key
Exemplo:custom.material

- Tipos de metafield não suportados
Alguns tipos de dados de metafield não são suportados, como tipos de referência ou MetaObjects.
Vermelho: metafields não suportados que não podem ser sincronizados pelo app

- Tipos de metafield diferentes entre as lojas
O metafield na Source e na Destination deve ter o mesmo tipo de dados e a mesma estrutura.
Incompatibilidades comuns incluem:
- Um metafield é Single line text, enquanto o outro é Multi-line text.
- Um metafield usa Single value, enquanto o outro usa List of values.
Para corrigir esses problemas, confirme que os metafields nas duas lojas têm o mesmo namespace, a mesma key e o mesmo tipo de dado, e depois tente sincronizar novamente.
🙋 Ainda precisa de suporte?
Se ainda precisar de ajuda, entre em contato conosco pelo e-mail hi@tipo.io. Teremos prazer em ajudar você.