---
title: "MetaobjectField"
description: "元对象中包含的单个元字段。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/metaobjects/objects/metaobject-field'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/metaobjects/objects/metaobject-field.md'
---
# MetaobjectField

元对象中包含的单个元字段。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Fields

* `key`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  元字段在其命名空间下的唯一标识符。

* `type`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  元字段支持的数据类型，有效枚举值包含：
  
  - `single_line_text_field`：单个单行文本
  - ` list.single_line_text_field`：多个单行文本
  - `multi_line_text_field`：多行文本
  - `rich_text_field`：富文本
  - `color`：单个颜色
  - `list.color`：多个颜色
  - `date`：单个日期
  - `list.date`：多个日期
  - `date_time`：单个日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。
  - `list.date_time`：多个日期和时间。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。
  - `url`：单个 URL
  - `list.url`：多个 URL
  - `file_reference`：单个文件，支持 10M 以内的 PDF 和图片文件，图片支持 JPG、JPEG、PNG 和 GIF 格式。
  - `list.file_reference`：多个文件，支持 10M 以内的 PDF 和图片文件，图片支持 JPG、JPEG、PNG 和 GIF 格式。
  - `json`：JSON 类型
  - `weight`：单个重量，带单位
  - `list.weight`：多个重量，带单位
  - `volume`：单个体积，带单位
  - `list.volume`：多个体积，带单位
  - `dimension`：单个尺寸，带单位
  - `list.dimension`：多个尺寸，带单位
  - `number_integer`：单个整数
  - `list.number_integer`：多个整数
  - `number_decimal`：单个小数
  - `list.number_decimal`：多个小数
  - `rating`：单个等级
  - `list.rating`：多个等级
  - `page_reference`：单个页面
  - `list.page_reference`：多个页面
  - `product_reference`：单个商品
  - `list.product_reference`：多个商品
  - `variant_reference`：单个商品款式
  - `list.variant_reference`：多个商品款式
  - `collection_reference`：单个商品分类
  - `list.collection_reference`：多个商品分类
  - `boolean`：布尔类型，有效值包括 `true` 和 `false`。
  - `money`：资金，带币种单位    
      
  关于更多元字段信息，参考 [元字段功能使用指南](https://help.shopline.com/hc/zh-cn/articles/7095355017113)。              

* `value`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  存储在元字段中的数据。   
  

## Field from

* [Metaobject](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/metaobjects/objects/metaobject.md).fields