Yikfy

Shopify Metafields: What They Do for SEO

A metafield does nothing until your theme prints it. What metafields really change, which ones earn their place, and how to fill 400 of them.

A Shopify metafield does nothing for SEO until your theme prints it on the page. Until then it is storage: real, structured, useful storage, and completely invisible to Google, to shoppers and to your own collection filters.

That is the sentence half the advice on this query leaves out. Metafields get sold as an SEO feature, and they are not one. What they are is the only place on a Shopify product where structured facts can live, and structured facts are what turn a product page into something more than a paragraph and a price.

What is a Shopify metafield?

A custom field on a Shopify object. Products, variants, collections, customers, orders and the shop itself can all carry them, and each one holds a typed value: text, a number, a date, a file, a reference to another object.

Shopify's own description is that metafields extend the platform's data model with your own custom data. Everything else follows from that. A product has a title, a description, a price and a vendor because Shopify decided every store needs those. It does not have a "thread count", a "compatible with" or an "allergens" field, because most stores do not. Metafields are how you add the ones your catalogue needs.

Definitions and values: where the work actually is

This is the distinction that decides whether metafields ever do anything for your store.

A definition is the shape: a name, a namespace and key, a type, and validation rules. You create it once, in Settings, Custom data, and it takes about a minute. Shopify allows 256 definitions per resource type for a merchant, plus 256 for each installed app, which is far more than any catalogue needs.

A value is the content: this product's thread count is 400. That has to exist on every product, one at a time, and there is no shortcut hiding in the definitions screen.

So the work is not 6 definitions. It is 6 definitions multiplied by 400 products, which is 2,400 values, and that multiplication is the entire reason most stores have beautifully designed metafields sitting empty. The definition feels like the task. It is the setup.

Shopify also ships category metafields: when you set a product's category, the relevant standard definitions come with it, so an apparel product already offers fabric, sleeve length and fit without you inventing them. Use those before writing your own. Standard definitions are consistent with what Shopify's other surfaces expect, and they cost nothing to adopt.

Do metafields help SEO?

Indirectly, and through three different routes. It is worth separating them, because two are real and one is mostly wishful.

Route one: text on the page. A metafield connected to your theme renders as content. Once it renders, it is words on the page like any other words, and they are the words that answer the specific questions a product page usually leaves unanswered. "Compatible with Bosch GSR 12V", "no palm oil", "seat height 46 cm". Those are long-tail queries, and they are exactly the kind of phrase a product description written for a human tends to skip. This is the route that works.

Route two: filters and collections. Metafields feed storefront filters, and filters put products on pages that rank for category queries. That is the same indirect mechanism tags have, covered in Shopify product tags, and it is worth as much. The pages it feeds are the ones that compete for category searches, which is the argument made in full in collection page SEO.

Route three: structured data. Some themes and apps map metafields into the product schema, so a value ends up in the markup Google reads. This depends entirely on your theme and on the app doing the mapping, so check yours before believing it. Nothing about creating a metafield makes it structured data on its own.

What is not a route: the metafield existing. An unconnected metafield is a database row. Google never sees it.

Connecting a metafield to your theme

Nothing renders by default. In the theme editor you add a block or a text element and point it at the metafield through a dynamic source, which is the small database icon next to the field. On older vintage themes it means editing Liquid instead.

The two-minute test before you fill 400 values: create the definition, set the value on one product, connect it in the theme, and load that product page. If the value is not visible on the page, filling the other 399 buys you nothing but a tidy admin.

Can you filter by a metafield?

Yes, on the storefront and in the admin, and both have conditions worth knowing before you design the taxonomy.

On the storefront, through Shopify's Search & Discovery app. The metafield needs a definition with storefront access, and its type has to be one of the supported filter types: single line text, single line text list, decimal, integer, true or false, or a metaobject reference. A multi line text field cannot be a filter, which catches people out after they have filled it on the whole catalogue.

Two limits to design around: a store gets 25 filters in total, and each filter shows at most 100 values. Twenty-five is generous for one collection and tight for a store trying to give every category its own filter set.

In the admin, the product list can filter by a metafield value if the definition has that option activated. It is the only field-level filter the admin offers beyond the built-in ones, which makes a well-chosen metafield the closest thing Shopify has to a custom product view.

Which metafields earn their place?

The test is not "is this true about the product". It is "will this show on the page, feed a filter, or answer a question that stops a sale". Everything else is data entry.

Category Metafields that pay for themselves Where they show up
Apparel Material, fit, care instructions, sleeve length Spec block, filters
Electronics Compatibility, voltage, warranty length, box contents Spec block, long-tail queries
Food and drink Ingredients, allergens, net weight, origin Spec block, compliance
Furniture Dimensions, assembly required, weight capacity Spec block, filters, returns
Beauty Ingredients, skin type, volume, cruelty free Spec block, filters
Spare parts Compatible models, OEM reference The only queries that find these products
Any catalogue Country of origin, care or usage notes Spec block, trust

Spare parts deserve the special mention. For that catalogue the compatibility metafield is not an enhancement, it is the product page: nobody searches for the part number they do not know, they search for the machine they own.

How to fill metafields across a catalogue

Four routes, in order of how many products they suit.

One product at a time, on the product page. Correct for ten products, and how everyone discovers the multiplication problem.

The bulk editor. Select products, click Edit products, and add metafield columns. It is a spreadsheet-style grid in the admin, and it is genuinely fast for a few dozen rows of short values. Note that variant metafields have to be done through the variant bulk editor instead.

CSV import and export. Once a product metafield is defined, it appears in your product export under a column named Name (product.metafields.namespace.key), and you can import the same column back. This is the workhorse for a restructure, and the same warnings apply as for any Shopify import: a blank cell in an overwrite import clears the value. Variant metafields are not supported in the product CSV, which is the limitation that sends most large catalogues to an app or the API.

Generate them. For values that are derivable from the product itself, care instructions, material, a spec summary, a usage note, writing 400 by hand is a week that produces text nobody disputes. This is the case where automation is genuinely the right tool, and the case where it is not is any value that must be factually exact and is not stated anywhere in the product data. Nobody should be generating voltages.

Whichever route: fill one product first, look at the page, then do the rest. The order in that sentence is the whole difference between a catalogue with working metafields and a catalogue with 2,400 invisible values.

One thing worth doing before any of it: count how many products are missing the fields that already exist, the description, the meta title, the meta description. Metafields are an extra layer of detail on a product page, and they are the wrong place to start if the page underneath them is still empty. The counting method is in the Shopify SEO audit.

Metafields or metaobjects?

A metafield holds a value on an object. A metaobject is an object of your own, with its own fields, that many products can point at.

The rule of thumb: if the same content repeats across products and has more than one field, it wants to be a metaobject. A size guide, a care standard, a supplier profile, a fabric with its own name, composition and origin. If the value is specific to one product, it is a metafield. Most stores need metafields and no metaobjects, and adding metaobjects early is a good way to build a schema you then maintain for nothing.

FAQ

What is a metafield in Shopify? A custom field on a Shopify object such as a product, variant or collection. It holds a typed value, text, number, date, file or reference, that Shopify's built-in fields do not cover. You define it once in Settings, Custom data, then set a value per product.

Do Shopify metafields help SEO? Only once they render on the page. A metafield connected to your theme becomes text Google reads, and that text often answers the specific long-tail questions your description skips. A metafield that is not connected to the theme is invisible to search engines entirely.

How many metafields can a Shopify product have? A merchant can create up to 256 metafield definitions per resource type, and each installed app gets its own 256. Most metafield types cap the value at 64KB, with JSON allowed 128KB and list types limited to 128 items.

Can I use metafields as storefront filters? Yes, through the Search & Discovery app, if the definition has storefront access and uses a supported type: single line text, single line text list, decimal, integer, true or false, or a metaobject reference. A store can show 25 filters in total, and each filter displays up to 100 values.

Can I import metafields with a CSV? Product metafields, yes. Once defined, they appear in the product export as Name (product.metafields.namespace.key) and can be imported back under the same header. Variant metafields are not supported in the product CSV and need the variant bulk editor or the API.

What is the difference between a metafield and a metaobject? A metafield stores a value on an existing object. A metaobject is a reusable custom object with its own fields that many products can reference, which suits repeated content such as a size guide or a supplier profile.


The honest summary is that metafields are a two-part job with a lopsided split. The definitions take an afternoon and feel like progress. The values take a week and are the part that actually shows up on the page.

Yikfy works on the second half. It reads the product metafield definitions you have already created and fills them across the products you select, either with a fixed value for the whole selection or with a value written from each product's own data, in the same run that writes the description, the meta title and the meta description. Everything waits in a review queue until you approve it.

Two limits, stated plainly. It fills definitions that exist, it does not create them, so the Settings, Custom data step stays yours. And it writes text: a spec sentence, a care note, a material, a usage summary. A measurement that has to be exact and is not stated anywhere in the product data is not a field to generate, for us or for anyone.