Metafield 定义

Metafield 允许您为 Shopify 中的产品、订单、客户和其他资源存储自定义数据。它们对于添加额外信息（如尺寸指南、规格、SEO 数据或内部备注）非常有用。

了解更多关于 Shopify 中的 metafield →

使用 DataEase，您可以通过文件中的动态列轻松地导入、导出和更新 metafield。

📊 Metafield 在 DataEase 中的工作原理

当您从 DataEase 导出数据时，metafield 显示为动态列。这意味着每个 metafield 在文件中都有自己的列，使用特定的命名格式：

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

示例：

metafield global.description_tag [single_line_text_field]

此结构告诉 DataEase（和 Shopify）您指的是哪个 metafield，以及以何种格式。

🧠 Metafield 导入逻辑

如果 metafield 不在您的导入文件中，它将不会被更改。
如果 metafield 在文件中但为空，它将从 Shopify 中删除。
如果 metafield 有值，它将被创建或更新。

这使得管理 metafield 变得容易，而不会覆盖您不想更改的数据。

🧩 支持的 Metafield 类型

Shopify 支持多种 metafield 类型。您可以在这里查看完整列表：

在导入时在您的列标题中使用这些类型。例如：

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

📏 Metafield 限制

在使用 metafield 之前，请注意 Shopify 的限制：

🔢 每个资源的限制

每种资源类型250个定义
每种资源类型20个固定定义

📦 按类型的字符限制

类型	字符限制
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

查看完整的 metafield 限制 →

🔐 所有者类型和访问权限（Admin API 2026-07）

库存转移（TRANSFER） — 库存转移的 metafield 定义现在可以在店铺间导出、导入和复制。导入它们需要库存转移权限（read_inventory_transfers、write_inventory_transfers），该应用自 2026 年 9 月 27 日起会请求此权限。在店铺所有者打开 DataEase 并批准更新的权限之前，TRANSFER 行会失败并显示要求批准的错误；其他所有行照常导入。
您自己命名空间中的管理员访问权限（accessAdmin）（例如 custom）——Shopify 在此处只允许一个值，因此 DataEase 不会为此类定义发送 accessAdmin，由 Shopify 自行应用。文件中的 PUBLIC_READ / PUBLIC_READ_WRITE 值不再导致 Shopify 报错。
应用命名空间中的管理员访问权限（$app、app--…）——MERCHANT_READ 和 MERCHANT_READ_WRITE 会按原样发送；旧文件中遗留的 PUBLIC_READ / PUBLIC_READ_WRITE 值会以 MERCHANT_READ / MERCHANT_READ_WRITE 发送。

🧰 用例示例

为产品添加自定义 SEO 标签：

使用 DataEase 导出产品
添加新列：metafield global.title_tag [single_line_text_field]
在列中输入您的 SEO 标题
导入更新后的文件 - 您的 metafield 现在已上线！

✅ 最佳实践

在方括号中使用每个 metafield 的正确格式。
避免覆盖重要数据 - 删除您不想更改的字段的列。
使用导出备份您当前的 metafield，然后再进行更改。

Metafield 是扩展您的 Shopify 商店功能的强大方式。使用 DataEase，您可以高效地批量管理它们，而无需编写代码。

其他字段

DataEase 支持此实体的更多列：

accessAdmin — metafield 定义的管理员访问级别。仅适用于应用命名空间（参见上文所有者类型和访问权限）。
accessCustomer — metafield 定义的客户访问级别。
accessStoreFront — metafield 定义的店面访问级别。
capabilitiesAdminFilterableEnabled — 指示是否为 metafield 启用了管理员过滤。
capabilitiesAdminFilterableEligible — 管理员过滤功能的资格状态。
capabilitiesAdminFilterableStatus — 管理员过滤功能的当前状态。
capabilitiesSmartCollectionConditionEnabled — 指示是否为 metafield 启用了智能集合条件。
capabilitiesSmartCollectionConditionEligible — 智能集合条件功能的资格状态。
capabilitiesUniqueValuesEnabled — 指示是否为 metafield 启用了唯一值。
capabilitiesUniqueValuesEligible — 唯一值功能的资格状态。
constraintsKey — 应用于 metafield 键的约束。
constraintsValues — 应用于 metafield 值的约束。
metafieldsCount — 与定义关联的 metafield 数量。
pinnedPosition — 指示 metafield 是否在管理员中固定。
metafieldsValidationStatus — metafield 的验证状态。
category — metafield 定义的类别。
description — metafield 定义的描述。
key — metafield 定义的键。
name — metafield 定义的名称。
namespace — metafield 定义的命名空间。
ownerType — 与 metafield 定义关联的所有者类型（例如 PRODUCT、CUSTOMER、TRANSFER）。
type — metafield 定义的数据类型。
validations — metafield 定义的验证 JSON 数组。
deleteAssociatedMetafields — 指示是否应删除关联的 metafield。