Skip to content
帮助中心

元字段定义的组成部分

在创建元字段前,您需要先定义其结构与应用范围。每条元字段定义指定该字段适用于哪个模块(如产品、规格或客户),并设置字段值的类型、验证规则等。

一个完整的元字段定义包含以下部分:

字段名称是否必填描述
名称元字段在 Genstore 后台中显示的名称,例如 Color。仅用于界面展示,无需唯一。
命名空间和密钥- 元字段的唯一识别码,格式为 namespace.key,如 custom.color
- 您可用命名空间将相关字段分组,每个组合必须全平台唯一。
- 仅支持字母、数字、下划线 (_) 和连字符 (-),如 products.expiration_date
类型字段值的数据类型,如文本、日期、URL、布尔值等。定义后将决定字段的输入控件和数据格式。更多信息,可阅读 元字段数据类型
描述用于引导商户正确输入字段值。例如说明填写格式、用途或示例。该内容将显示在后台页面中。
验证对字段值设置格式或范围限制。支持字符长度、正则表达式或预设选项。仅适用于特定数据类型。部分选项互斥,例如“预设选项”不能与“最小/最大字符数”同时启用。
值列表是否支持为该字段输入多个值(如多个标签、颜色或文件)。启用后将以列表形式展示,字段类型必须支持多值输入。
选项(访问权限)控制该字段是否允许通过 Liquid 模板或 Storefront API 被读取:
- 读取:可用于前台展示
- 无访问权限:仅用于后台管理,无法被前台获取

示例

产品到期日期 为例,其元字段定义可能为:

  • 命名空间与密钥: products.expiration_date
  • 类型: 日期
  • 描述:YYYY/MM/DD 格式填写
  • 验证规则: 仅允许 2025/01/012030/12/31 之间的日期

如需了解每种字段类型的格式和用途,请阅读 元字段的开发人员文档