[!info] related notes

• 所属 MOC: Shopify MOC
• 相关 API: Shopify Admin API

Shopify Metafield

一句话定义

Metafield 是 Shopify 的自定义字段系统，允许为产品、变体、订单、客户等对象存储额外的结构化数据。

核心用途

默认字段不够用时

产品默认字段：标题、描述、价格、图片

但商家可能需要：

• 产品材质（cotton/polyester）
• 生产国家
• 护理说明
• 尺码表
• 视频 URL

解决方案：使用 Metafield 存储这些额外信息

最小例子

创建 Metafield

mutation {
  productUpdate(input: {
    id: "gid://shopify/Product/123"
    metafields: [
      {
        namespace: "custom"
        key: "material"
        value: "100% Cotton"
        type: "single_line_text_field"
      }
    ]
  }) {
    product {
      id
      metafield(namespace: "custom", key: "material") {
        value
      }
    }
  }
}

在主题中显示

{% if product.metafields.custom.material %}
  <p>Material: {{ product.metafields.custom.material }}</p>
{% endif %}

Metafield 结构

• namespace：命名空间（如 custom、app）
• key：键名（如 material、size_chart）
• value：值（文本、数字、JSON）
• type：数据类型（single_line_text、number_integer、json 等）

适用对象

• Product（产品）
• Product Variant（变体）
• Collection（集合）
• Customer（客户）
• Order（订单）
• Shop（商店）

Related notes

• Shopify MOC
• Shopify Admin API