Show Shopify Metafields on Product Pages
A metafield stores extra information, such as care instructions or dimensions, against a product. Create a definition, add a value to each product, then connect the field to your theme. If your theme supports dynamic sources you can do that in the theme editor; otherwise you can edit the theme code.
By Charles · Published · Updated

A metafield is an extra field attached to a product, such as care instructions or dimensions. To show it on the storefront you create the field, fill it in, and connect it to your theme. Whether that takes a few clicks or a developer depends on your theme.
For the wider layout context, see our guide to custom Shopify theme sections. Need a field built into your product page? Send a project brief to discuss the work.
Key facts
- Metafields extend a Shopify data model, such as products, with your own custom data. Shopify Help Center, checked 10 November 2026.
- Setting one up means adding a definition, adding values, and optionally connecting it to your theme. Shopify Help Center, checked 10 November 2026.
- Each text or rich text setting can have up to 50 dynamic sources, and each template up to 100. Shopify Help Center, checked 10 November 2026.
What is a Shopify metafield?
A metafield is a custom piece of data stored against part of your store, such as a product. Shopify's examples include care instructions, recommended age, dimensions and a size chart, each with its own value for each product. See Shopify's metafields overview, checked 10 November 2026.
The point is to keep structured information out of the product description. Shopify describes showing, for example, width, height and depth in a dedicated section of your theme instead of a paragraph of text.
How do you set up a product metafield?
There are three tasks: add a definition, add values, and optionally connect the field to your theme. Shopify lists them in this order in its metafields guide, checked 10 November 2026.
- Add a definition. The definition says which part of the store the field applies to and what values it accepts. Shopify says to use a standard definition whenever possible, because standard definitions work across apps, themes and other parts of your store. Create a custom definition only when no standard one fits. See adding metafield definitions, checked 10 November 2026.
- Add values. Fill in the field on each product that needs it. A product with no value has nothing to show.
- Connect it to your theme. This is the step that makes it visible to customers, and the one that depends on your theme.
A store can have up to 256 definitions for each type, such as products or customers.
Can you show a metafield in the theme editor?
Yes, if your theme supports dynamic sources. Shopify says you connect a metafield by adding a section or block that supports dynamic sources, then choosing the field with the connect dynamic source icon. For example, a Product info section can support product metafields. See displaying metafields on your online store, checked 10 November 2026.
Which metafields are available depends on the theme, and Shopify points merchants to the theme's documentation or its developer. In a text or rich text setting you can insert more than one dynamic source, one metafield at a time, within the limits in the key facts above.
When do you need theme code or a custom section?
You need code when your theme cannot connect the field. Shopify says that if you use a vintage theme, or want a metafield type your theme does not support, you can edit your theme code and reference the metafield with Liquid. It also says to edit theme code only if you have coding experience.
Product reference lists are a specific case: Shopify says they require a custom section or a third-party theme that uses product list settings. A new section built around the field and editable in the theme editor is the kind of work our Custom Section package covers. It is one new theme section, editable in the Shopify theme editor, for a fixed $699 USD. See the custom theme sections service, and note that package examples describe possible requests rather than a promise that every request fits one job.
If the information comes from an app instead, compare app blocks and app embeds.
How do you check a metafield before it goes live?
Connect it on a duplicate theme and preview real products before you publish. Shopify says it is a good idea to duplicate a theme before customizing it so you can discard changes and start again (checked 10 November 2026).
- Preview a product that has a value and one that does not, so you can see the empty case.
- Check the field on mobile and on desktop.
- Check every product template that should show it, because a change to a shared template affects more than one product. Our template changes guide explains how to find which pages share a layout.
- Check page speed afterwards with our Shopify speed guide.
Can Ecommerce Nerds build the section for you?
If your theme cannot show the field, a custom section can. Describe the product page, the metafield names and how they should look in a brief, and we will confirm the fit and send a fixed quote within one business day before you pay. Read how a project works first if you want the steps.
Frequently asked questions
Do I need an app to show metafields on my product page?
Not always. Shopify says that if your theme supports dynamic sources you can connect most metafields in the theme editor. If your theme is a vintage theme or you need a metafield type it does not support, you can edit the theme code.
Why is my metafield not showing on the product page?
Check that the product has a value, that the field is connected to a section or block that supports dynamic sources, and that your theme supports that metafield type. Shopify says to check your theme's documentation for the metafields it supports.
How many metafield definitions can a store have?
Shopify says you can have up to 256 metafield definitions for each type, such as products or customers.
Can I show a list of related products from a metafield?
Shopify says product reference lists require a custom section or a third-party theme that uses product list settings. A custom section is the kind of work our Custom Section package covers; send a brief and we will confirm the fit.
Have a product page to extend? Send a project brief with the fields and where they should appear.