Skip to content
Now with GPT-6 Astra support

Product Metafields

Custom Product Fields

Last updated: November 13, 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, JSON, or File (PDF)
  • Value — or, for a File field, a PDF upload of up to 10 MB
  • 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, and PDF files as a Download PDF link — ideal for assembly guides and manuals).
  • 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
PDF files Admin → Catalog → Product Files lists every uploaded PDF across all products, where you can search, open, replace, rename, change visibility, or delete them