Definição de Metafield

Metafields permitem que você armazene dados personalizados para produtos, pedidos, clientes e outros recursos no Shopify. Eles são úteis para adicionar informações extras como guias de tamanhos, especificações, dados de SEO ou notas internas.

Saiba mais sobre metafields no Shopify →

Com o DataEase, você pode importar, exportar e atualizar metafields facilmente usando colunas dinâmicas em seus arquivos.

📊 Como Funcionam os Metafields no DataEase

Quando você exporta dados do DataEase, os metafields são exibidos como colunas dinâmicas. Isso significa que cada metafield ganha sua própria coluna no arquivo, usando um formato de nomenclatura específico:

metafield {namespace}.{name} [{type}]

Exemplo:

metafield global.description_tag [single_line_text_field]

Essa estrutura informa ao DataEase (e ao Shopify) a qual metafield você está se referindo e em qual formato.

🧠 Lógica de Importação de Metafield

Se um metafield não estiver no seu arquivo de importação, ele não será alterado.
Se um metafield estiver no arquivo, mas vazio, ele será excluído do Shopify.
Se um metafield tiver um valor, ele será criado ou atualizado.

Isso facilita o gerenciamento de metafields sem sobrescrever dados que você não deseja alterar.

🧩 Tipos de Metafield Suportados

O Shopify suporta uma ampla gama de tipos de metafield. Você pode ver a lista completa aqui:

Use esses tipos nos cabeçalhos das suas colunas ao importar. Por exemplo:

metafield specs.material [multi_line_text_field] metafield shipping.weight [number_decimal]

📏 Limites de Metafield

Antes de trabalhar com metafields, esteja ciente dos limites do Shopify:

🔢 Limites por recurso

250 definições por tipo de recurso
20 definições fixadas por tipo de recurso

📦 Limites de caracteres por tipo

Tipo	Limite de Caracteres
boolean	65,000
color	65,000
date	65,000
date_time	65,000
dimension	65,000
id	2,048
json	2,000,000
link	65,000
money	65,000
multi_line_text_field	65,000
number_decimal	65,000
number_integer	65,000
rating	65,000
rich_text_field	65,000
single_line_text_field	65,000
url	2,048
volume	65,000
weight	65,000

Veja todos os limites de metafield →

🔐 Tipos de proprietário e acesso (Admin API 2026-07)

Transferências de estoque (TRANSFER) — definições de metafield de transferências de estoque podem ser exportadas, importadas e copiadas entre lojas. Importá-las requer a permissão de transferências de estoque (read_inventory_transfers, write_inventory_transfers), que o aplicativo solicita desde 27 de setembro de 2026. Até que o proprietário da loja abra o DataEase e aprove as permissões atualizadas, as linhas TRANSFER falham com um erro pedindo para aprová-las; todas as outras linhas são importadas normalmente.
Acesso de administrador (accessAdmin) em seus próprios namespaces (por exemplo, custom) — o Shopify permite apenas um valor ali, então o DataEase não envia accessAdmin para essas definições e o Shopify o aplica por conta própria. Um valor PUBLIC_READ / PUBLIC_READ_WRITE no arquivo não causa mais um erro do Shopify.
Acesso de administrador em namespaces de aplicativo ($app, app--…) — MERCHANT_READ e MERCHANT_READ_WRITE são enviados como estão; valores legados PUBLIC_READ / PUBLIC_READ_WRITE de arquivos antigos são enviados como MERCHANT_READ / MERCHANT_READ_WRITE.

🧰 Exemplo de Caso de Uso

Adicionar tags de SEO personalizadas aos produtos:

Exporte produtos com o DataEase
Adicione uma nova coluna: metafield global.title_tag [single_line_text_field]
Insira seus títulos de SEO na coluna
Importe o arquivo atualizado - seus metafields agora estão ativos!

✅ Melhores Práticas

Use o formato correto entre colchetes para cada metafield.
Evite sobrescrever dados importantes - remova colunas para campos que você não deseja alterar.
Use a exportação para fazer backup dos seus metafields atuais antes de fazer alterações.

Metafields são uma maneira poderosa de estender a funcionalidade da sua loja Shopify. Com o DataEase, você pode gerenciá-los de forma eficiente - em massa - e sem precisar escrever código.

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

accessAdmin — Nível de acesso do administrador para a definição de metafield. Aplicado apenas a namespaces de aplicativo (veja Tipos de proprietário e acesso acima).
accessCustomer — Nível de acesso do cliente para a definição de metafield.
accessStoreFront — Nível de acesso da vitrine para a definição de metafield.
capabilitiesAdminFilterableEnabled — Indica se o filtro de administrador está habilitado para o metafield.
capabilitiesAdminFilterableEligible — Status de elegibilidade para a capacidade de filtro de administrador.
capabilitiesAdminFilterableStatus — Status atual da capacidade de filtro de administrador.
capabilitiesSmartCollectionConditionEnabled — Indica se a condição de coleção inteligente está habilitada para o metafield.
capabilitiesSmartCollectionConditionEligible — Status de elegibilidade para a capacidade de condição de coleção inteligente.
capabilitiesUniqueValuesEnabled — Indica se valores únicos estão habilitados para o metafield.
capabilitiesUniqueValuesEligible — Status de elegibilidade para a capacidade de valores únicos.
constraintsKey — Restrições aplicadas à chave do metafield.
constraintsValues — Restrições aplicadas aos valores do metafield.
metafieldsCount — Número de metafields associados à definição.
pinnedPosition — Indica se o metafield está fixado no administrador.
metafieldsValidationStatus — Status de validação dos metafields.
category — Categoria da definição de metafield.
description — Descrição da definição de metafield.
key — Chave para a definição de metafield.
name — Nome da definição de metafield.
namespace — Namespace para a definição de metafield.
ownerType — Tipo de proprietário associado à definição de metafield (por exemplo, PRODUCT, CUSTOMER, TRANSFER).
type — Tipo de dado da definição de metafield.
validations — Array JSON de validações para a definição de metafield.
deleteAssociatedMetafields — Indica se os metafields associados devem ser excluídos.