Lorixen.
EN

Shopify Metafields for Product Specs and Filters: How-To

Short answer: Metafields are extra, structured fields you add to Shopify products, such as material, width or burn time. Define each spec once with the right type, fill it in for your products, connect it to your product page in the theme editor, then add it as a filter through Shopify's Search & Discovery app. The two decisions that matter most are choosing field types that filters can use, and keeping values consistent so "Merino" and "merino wool" don't become two separate filter options.

Specs buried in a product description paragraph can't be filtered, compared or reused. A shopper looking for a 140 cm-wide linen tablecloth has to open every product to find the width. Moving specs into metafields fixes that.

Before you start: metafield or metaobject?

Shopify's developer documentation draws the line clearly:

  • Metafields add individual custom fields to an existing resource, like a product. "Material: linen" or "Width (cm): 140" are metafields.
  • Metaobjects are standalone structures with several related fields that can be reused across the store. Shopify's own examples include a size chart with multiple measurements and an ingredient list with nutritional data.

A rule of thumb: if the information belongs to one product, use a metafield. If the same block of information is shared by many products (one size chart for all your tees, one care guide for all wool items), build it as a metaobject and reference it from each product.

Step 1: list the specs customers actually compare

Look at the questions you get by email and the details competitors list. For a hypothetical Christchurch homewares store, that might be:

  • Material (linen, cotton, wool blend)
  • Width and length in cm
  • Colour family
  • Care (machine washable yes/no)
  • Made in (New Zealand, Portugal, India)

Keep it to the five to eight specs that drive decisions. Every extra field is data someone has to maintain.

Step 2: choose the right types

The type decides what you can do with the field later. Shopify's storefront filtering documentation lists the metafield types that can power filters, including single-line text, lists of single-line text, metaobject references, integers, decimals and true/false (as of November 2026).

Practical choices:

  • Material, colour family, origin: single-line text with a fixed list of allowed values, or a metaobject reference if you want a swatch image or description per value.
  • Width, length, weight: a number (integer or decimal) with the unit in the field name, such as "Width (cm)".
  • Machine washable: true/false.
  • Long care instructions: multi-line or rich text for display only; don't plan to filter on it.

Step 3: create the definitions

In the Shopify admin, go to the custom data settings and add a product metafield definition for each spec. Give each one a clear name, pick the type, and where offered, add validation such as a list of allowed values or a minimum and maximum.

Before creating your own, check Shopify's standard definitions. Shopify maintains a list of standard metafield definitions for common use cases, and using one can save work. Also check your product categories: Shopify's standard product taxonomy is made up of categories, attributes and attribute values, and when you assign a category in the admin, Shopify may offer category-specific attribute fields. Use those where they fit rather than duplicating them.

Step 4: fill in the values

For a small catalogue, fill values on each product page. For hundreds of products, use the admin's bulk editing tools with metafield columns, an import app, or the GraphQL Admin API, which Shopify's docs point to for merchant-owned metafields.

Consistency is everything here. Decide spelling and capitalisation up front ("Linen", not "linen" or "100% linen") and stick to it. Fixed allowed values enforce this for you.

Step 5: show specs on the product page

Shopify themes connect metafields through dynamic sources: in the theme editor, you add a text or spec block to the product template and link its content to a metafield instead of typing fixed text. Shopify's theme documentation notes that dynamic sources work in section and block settings, not general theme settings.

A tidy layout is a short spec list under the price or in a "Details" tab:

  • Material: Linen
  • Size: 140 × 250 cm
  • Care: Machine washable

If a product has no value for a field, a well-built block hides that row rather than showing an empty label.

Step 6: turn specs into filters

Install Shopify's free Search & Discovery app, open its filters section, and add your metafields as filters. Shopify's developer documentation notes a maximum of 25 filters, and that filters combine with AND logic while values within a filter use OR: "Linen AND Blue", or "Blue OR Green".

Prioritise the filters people actually use. On a homewares store, material and size probably matter more than country of origin.

Troubleshooting

My metafield doesn't appear as a filter option. Check the type. Multi-line and rich text fields can't be used for filters; recreate the definition as single-line text or a list.

The same value shows twice in a filter. Usually spelling or spacing differences ("Wool" and "wool "). Clean the values, then add allowed values to stop it recurring.

Specs show on some products but not others. The value is missing on those products, or they use a different product template that doesn't include the block.

Number filters behave oddly. The field may have been created as text, so "100" sorts before "20". Number specs should use a number type.

Too many filter options overwhelm shoppers. Group values. Instead of 30 exact colours, add a "Colour family" field with eight broad values.

FAQ

Do metafields help SEO?

Indirectly. Visible specs give search engines and shoppers more useful detail on the page. The metafield itself isn't a ranking factor.

Can I use metafields on variants as well as products?

Yes, metafields can be attached to many Shopify resources. Use variant metafields when the spec differs by variant, such as width per size.

Will changing a metafield type break my store?

It can affect blocks and filters connected to it. Plan types carefully at the start, and test changes on a duplicate theme.

Is there a limit on filters?

Shopify's filtering documentation states a maximum of 25 filters, as of November 2026.

Want specs and filters set up across a large catalogue without weeks of manual entry? Tell us about your product range.

Sources

WhatsAppLet’s talk