商品自訂欄位
自訂商品資料
最後更新：2026年9月5日
Metafields 是您可以加到任何商品上的自訂欄位——材質、尺寸、ISBN、保養說明、下載檔案，以及所有標準欄位未涵蓋的內容。它們會顯示在商品頁面上，也可透過 REST API 取得。
新增 Metafields #
編輯商品（管理後台 → 目錄 → 商品）並開啟 Metafields 分頁。新增欄位時需填寫：
- Key——簡短的機器名稱，例如
material - Label——顯示名稱（預設為整理過的 key）
- Type——文字、多行文字、數字、URL、日期、布林值或 JSON
- Value
- 顯示於商店前台——是否要出現在商品頁面上
可依需要新增任意數量的欄位並重新排序。
顯示位置 #
- 商店前台——可見的 metafields 會呈現在商品的規格分頁中（布林值顯示為「是／否」，URL 顯示為連結）。
- REST API——可見的 metafields 會包含在商品端點的
metafields之下，各自帶有 namespace、key、type 與具型別的值——非常適合整合與無頭商店前台使用。
注意事項 #
| 主題 | 細節 |
|---|---|
| 型別 | 透過 API 回傳的值會維持正確型別（數字為數字、布林值為 true/false、JSON 已解析） |
| 可見性 | 隱藏的 metafields 保留供內部使用，商店前台與 API 都不會包含 |
| Namespace | 欄位預設使用 custom namespace |