Zerogaps blog

Shopify metafields: the AI-readable product details standard fields miss

Shopify metafieldsAI visibilityproduct datastructured dataAEO

A shopper opens ChatGPT and types "waterproof hiking boots for wide feet under 150." That's not a keyword. It's a list of attributes: waterproof, hiking, wide fit, a price ceiling. The AI reads that question, then looks for products it can match against those exact details. If your boots are genuinely waterproof and come in wide sizes, but that information lives only inside a paragraph of marketing copy (or worse, only in a product photo), the AI has nothing clean to match. So it recommends a competitor whose data was easier to read.

This is the gap most Shopify stores have right now. Your default product fields, title, description, price, vendor, product type, were built for a world where humans browsed and clicked. They were not built for a world where an assistant parses structured attributes and answers "which one should I buy." Material, fit, use-case, dimensions, ingredients: the stuff shoppers actually ask about, Shopify doesn't store any of it in a machine-readable slot by default. Metafields are how you add those slots.

What a metafield actually is

Think of a metafield as a custom labeled box you attach to every product. Shopify gives you the standard boxes (title, price, description). A metafield lets you create new ones like "Material," "Fit," "Waterproof," "Capacity," or "Active ingredient," and then fill them in per product. The key word is labeled. A description that says "made from full-grain leather, runs wide" is just text. A metafield called Material with the value "Full-grain leather" is a labeled fact. AI assistants, Google, and your own theme can all read a labeled fact far more reliably than they can pull it out of a sentence.

If AI assistants currently skip past your catalog, thin or unstructured product data is usually part of why. I wrote more about that in why AI assistants ignore your products, and metafields are one of the most direct fixes on that list.

Where to create them (no code)

This lives entirely in your Shopify admin, no theme editing required to set up the fields themselves. Go to Settings, then Custom data, then Products. You'll see "Metafields" and "Metaobjects." For now you want Metafields. Click "Add definition." You give it a name (say, Material), Shopify generates a namespace and key automatically (something like custom.material), and you pick a type.

The type matters more than it looks. A few you'll actually use:

Once a definition exists, every product in your store gets that field on its edit page. Scroll to the bottom of any product and you'll see a Metafields section where you type the value in.

Pick the attributes shoppers in your niche actually ask about

Don't create forty metafields. Create the five to eight that match how people shop your category. The test is simple: if a real customer would ask a salesperson about it, or type it into ChatGPT, it deserves a metafield.

Fashion and footwear

Material (cotton, merino wool, full-grain leather), Fit (slim, regular, wide, oversized), Care (machine washable, dry clean), Use-case (running, formal, everyday), and Season. A shopper asking for "breathable running shirts for hot weather" is matching against material and use-case. If those are blank, you're invisible to that question even if the shirt is perfect.

Supplements and beauty

Active ingredient and amount, Form (capsule, powder, gummy), Servings per container, Dietary tags (vegan, gluten-free, sugar-free), and Concentration. "Vitamin D3 5000 IU vegan softgels" is four structured attributes stacked together. Each one should be its own metafield, not a phrase you hope the AI parses correctly from your description.

Home and goods

Dimensions (use the Dimension type, separate length, width, height), Capacity or volume, Material, Room or use-case (kitchen, outdoor, bedroom), and Assembly required. Someone searching "compact air fryer under 4 liters for a small kitchen" is filtering on capacity and use-case. Those need to be numbers and tags, not prose.

Getting metafields onto the page and into schema

Filling in the boxes is half the job. The data also has to be visible, on the product page for shoppers, and in your structured data for AI and search engines. Both matter, because assistants read both the human-facing page and the machine-readable schema underneath it.

For the visible part, most modern Shopify themes (Online Store 2.0 themes like Dawn) let you do this in the theme editor with zero code. Open Online Store, then Themes, then Customize, and on a product template add a block. Many themes have a "Metafield" or "Text" block where you can connect a "dynamic source" and point it at the metafield you created. That puts a clean labeled spec, "Material: Full-grain leather," right on the page where both people and crawlers see it. If your theme doesn't expose dynamic sources cleanly, a simple spec table in the description is a workable fallback while you plan a theme update.

For the schema part, the goal is to feed those attributes into the Product structured data (JSON-LD) that lives in your theme. AI assistants and Google read this to understand what a product is. Properties like material, color, size, and additionalProperty in Product schema map almost one to one onto the metafields you just built. If you're comfortable, you (or whoever set up your theme) can reference metafields inside the JSON-LD in theme.liquid or your product template using Shopify's Liquid syntax. If you'd rather not touch Liquid, a well-rated SEO or schema app can pull metafields into structured data for you. The important part is that "waterproof: true" and "capacity: 750 ml" end up as structured properties an assistant can trust, not just words on a page.

The mental model: metafields are the source of truth. From that one source you feed the product page, your collection filters, your structured data, and ultimately the answer an AI gives a shopper.

The filter bonus

There's a second payoff. Shopify's storefront filtering can use metafields too. Once you've defined Material or Fit as metafields with consistent values, you can turn them into collection filters from Settings, then Custom data, or in your search and discovery setup, so shoppers narrow "wide fit" or "vegan" on your own site. The same clean, consistent data that helps AI also makes your store easier to shop directly. You fill the data in once and it works in several places.

Start small, stay consistent

You don't need to backfill a thousand products this weekend. Pick your best-selling collection, define the five attributes that matter most for it, and fill them in. Use the exact same wording every time ("Wide," not "wide" on one product and "Wide fit" on another), because inconsistent values are almost as bad as missing ones. The AI is matching strings, and "merino wool" and "Merino Wool" can read as different things to a naive parser.

Not sure whether AI assistants currently see your products at all, or which attributes your competitors are winning on? You can run a free AI visibility audit and see exactly which shopper questions surface your store versus someone else's. That'll tell you which metafields are worth your time first, instead of guessing. Do one collection, check the result, then move to the next. That's the whole game.

See where your store stands

Run a free AI Visibility Audit and find out if AI recommends you.

Get my free audit →

Questions store owners ask

Do I need a developer to set up Shopify metafields?

No. You create the fields in Settings, then Custom data, then Products, with no code. Putting them on the product page is also code-free on Online Store 2.0 themes using dynamic sources in the theme editor. Only feeding them into JSON-LD schema by hand needs a bit of Liquid, and an app can handle that for you instead.

How are metafields different from the product description?

A description is free text. A metafield is a labeled fact, like Material set to Full-grain leather. AI assistants and search engines read labeled facts far more reliably than they pull details out of a paragraph, so metafields make your real product attributes machine-readable.

Which metafields should I create first?

Pick the five to eight attributes shoppers in your niche actually ask about. Fashion: material, fit, care, use-case. Supplements: active ingredient, form, dietary tags. Home goods: dimensions, capacity, material, room. If a customer would ask about it, it deserves a metafield.