Product Metafields
Custom Product Fields
Last updated: July 3, 2026
Metafields are custom fields you can add to any product — material, dimensions, ISBN, care instructions, downloads, and anything else not covered by the standard fields. They show on the product page and are available through the REST API.
Adding Metafields #
Edit a product (Admin → Catalog → Products) and open the Metafields tab. Add a field with:
- Key — a short machine name, e.g.
material - Label — the display name (defaults to a tidied version of the key)
- Type — Text, Multi-line, Number, URL, Date, Boolean, or JSON
- Value
- Show on storefront — whether it appears on the product page
Add as many as you need and reorder them.
Where They Appear #
- Storefront — visible metafields render in the product's Specifications tab (booleans show as Yes/No, URLs as links).
- REST API — visible metafields are included on the product endpoint under
metafields, each with its namespace, key, type, and typed value — handy for integrations and headless storefronts.
Notes #
| Topic | Detail |
|---|---|
| Types | Values are returned correctly typed via the API (numbers as numbers, booleans as true/false, JSON parsed) |
| Visibility | Hidden metafields are kept for internal use and excluded from both the storefront and the API |
| Namespacing | Fields default to the custom namespace |