---
title: "metafield"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/metafield'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/metafield.md'
---

# metafield


    附加到特定资源（如商品、订单等）的元字段。

    有关如何访问资源上的元字段，可参考 [get_metafield](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-metafield.md) 和 [get_metafields](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-metafields.md)。

元字段支持多种数据类型。若要以特定格式渲染或输出元字段，可以使用 [metafield_text](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/metafield-text.md) filter 和 [metafield_tag](https://developer.shopline.com/zh-hans-cn/docs/sline/tag/metafield-tag.md) tag。




## 属性

    <div>
    

        
<ObjectProperty
    name="list"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
元字段的值是否为列表。
- `true`：元字段的值是列表。
- `false`：元字段的值不是列表。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
元字段的类型。

<table>
  <thead>
    <tr>
      <th>可选值</th>
      <th>描述</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>single_line_text_field</td>
      <td>单行文本</td>
    </tr>
    <tr>
      <td>multi_line_text_field</td>
      <td>多行文本</td>
    </tr>
    <tr>
      <td>rich_text_field</td>
      <td>富文本</td>
    </tr>
    <tr>
      <td>product_reference</td>
      <td>商品</td>
    </tr>
    <tr>
      <td>collection_reference</td>
      <td>商品分类</td>
    </tr>
    <tr>
      <td>variant_reference</td>
      <td>商品款式</td>
    </tr>
    <tr>
      <td>page_reference</td>
      <td>页面</td>
    </tr>
    <tr>
      <td>article_reference</td>
      <td>博客文章</td>
    </tr>
    <tr>
      <td>file_reference</td>
      <td>文件</td>
    </tr>
    <tr>
      <td>number_integer</td>
      <td>整数</td>
    </tr>
    <tr>
      <td>number_decimal</td>
      <td>小数</td>
    </tr>
    <tr>
      <td>date</td>
      <td>日期</td>
    </tr>
    <tr>
      <td>date_time</td>
      <td>日期和时间</td>
    </tr>
    <tr>
      <td>url</td>
      <td>URL</td>
    </tr>
    <tr>
      <td>link</td>
      <td>链接</td>
    </tr>
    <tr>
      <td>json</td>
      <td>JSON</td>
    </tr>
    <tr>
      <td>boolean</td>
      <td>布尔值</td>
    </tr>
    <tr>
      <td>color</td>
      <td>颜色</td>
    </tr>
    <tr>
      <td>weight</td>
      <td>重量</td>
    </tr>
    <tr>
      <td>volume</td>
      <td>体积</td>
    </tr>
    <tr>
      <td>dimension</td>
      <td>尺寸</td>
    </tr>
    <tr>
      <td>rating</td>
      <td>评分</td>
    </tr>
    <tr>
      <td>money</td>
      <td>金额</td>
    </tr>
    <tr>
      <td>metaobject</td>
      <td>元对象</td>
    </tr>
  </tbody>
</table>
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="value"
    types={[<Mdx>any</Mdx>]}
>
<ObjectSummary>
元字段的值。

下表列出了各元字段类型的值所支持的格式：

<table>
  <thead>
    <tr>
      <th>类型</th>
      <th>返回值格式</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        `single_line_text_field`
          
          `multi_line_text_field`
      </td>
      <td>[字符串](https://developer.shopline.com/zh-hans-cn/docs/sline/basics.md#UpnuY)</td>
    </tr>
    <tr>
      <td>
        `rich_text_field`
      </td>
      <td>富文本（支持标题、列表、粗体、斜体和链接格式）</td>
    </tr>
    <tr>
      <td>
        `product_reference`
      </td>
      <td>[product](https://developer.shopline.com/zh-hans-cn/docs/sline/object/product.md) 对象</td>
    </tr>
    <tr>
      <td>
        `collection_reference`
      </td>
      <td>[collection](https://developer.shopline.com/zh-hans-cn/docs/sline/object/collection.md) 对象</td>
    </tr>
    <tr>
      <td>
        `variant_reference`
      </td>
      <td>[variant](https://developer.shopline.com/zh-hans-cn/docs/sline/object/variant.md) 对象</td>
    </tr>
    <tr>
      <td>
        `page_reference`
      </td>
      <td>[page](https://developer.shopline.com/zh-hans-cn/docs/sline/object/page.md) 对象</td>
    </tr>
    <tr>
      <td>
        `article_reference`
      </td>
      <td>[article](https://developer.shopline.com/zh-hans-cn/docs/sline/object/article.md) 对象</td>
    </tr>
    <tr>
      <td>
        `file_reference`
      </td>
      <td>
        以下其中之一：
          <ul>
              <li>`generic_file` 对象</li>
              <li>[image](https://developer.shopline.com/zh-hans-cn/docs/sline/object/image.md) 或 [video](https://developer.shopline.com/zh-hans-cn/docs/sline/object/video.md) 对象</li>
          </ul>
      </td>
    </tr>
    <tr>
      <td>
        `number_integer`
          
        `number_decimal`
      </td>
      <td>[数字](https://developer.shopline.com/zh-hans-cn/docs/sline/basics.md#Rdi15)</td>
    </tr>
    <tr>
      <td>
          `date`
         
          `date_time`
      </td>
      <td>日期字符串（可使用 [date](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md) filter 进行格式化）</td>
    </tr>
    <tr>
      <td>
        `url`
      </td>
      <td>URL [字符串](https://developer.shopline.com/zh-hans-cn/docs/sline/basics.md#UpnuY)</td>
    </tr>
    <tr>
      <td>
        `link`
      </td>
      <td>链接对象</td>
    </tr>
    <tr>
      <td>
        `json`
      </td>
      <td>[JSON](https://developer.mozilla.org/docs/Learn/JavaScript/Objects/JSON) 对象</td>
    </tr>
    <tr>
      <td>
        `boolean`
      </td>
      <td>[布尔值](https://developer.shopline.com/zh-hans-cn/docs/sline/basics.md#DeWGb)</td>
    </tr>
    <tr>
      <td>
        `color`
      </td>
      <td>[color](https://developer.shopline.com/zh-hans-cn/docs/sline/object/color.md) 对象</td>
    </tr>
    <tr>
      <td>
        `weight`

        `volume`

        `dimension`
      </td>
      <td>测量对象</td>
    </tr>
       
    <tr>
      <td>
        `rating`
      </td>
      <td>评分对象</td>
    </tr>
    <tr>
      <td>
        `money`
      </td>
      <td>货币金额对象</td>
    </tr>
    <tr>
      <td>
        `metaobject`
      </td>
      <td>[metaobject](https://developer.shopline.com/zh-hans-cn/docs/sline/object/metaobject.md) 对象</td>
    </tr>
  </tbody>
</table>
</ObjectSummary>
</ObjectProperty>
        
    
    </div>