Shopify Metafields and Metaobjects: A Practical Guide

Metafields and metaobjects are how you store information that Shopify doesn't have a built-in field for. That includes product specs, ingredients, care instructions, size charts, FAQs, designer profiles and anything else that makes your catalog specific to you. They're also how that information reaches your theme, your filters and, increasingly, the AI shopping channels that read your product data.

The short version: a metafield adds one custom field to an existing record, such as "fabric" on a product. A metaobject is a reusable content type with several fields of its own, such as a "size chart" with a title, a table image and fit notes, which you can attach to many products. Both are native to Shopify, both are managed in the admin without an app, and both connect to Online Store 2.0 themes through the theme editor.

This guide explains how each works as of October 2026, when to use which, how to show them on your store, the limits that matter, and how they help SEO.

What metafields are

Shopify's Help Center defines them simply: "Metafields allow you to extend an existing platform data model, such as products, customers, and orders with your own custom data." You first create a definition (the field's name, namespace and key, type and validation rules), then fill in values on each record.

Each definition has a type. Common ones include:

• Text: single-line text, multi-line text and rich text (headings, lists, links, bold and italic).
• Numbers and measurements: integer, decimal, money, and measurement types such as dimension, weight, volume and rating.
• Other values: true/false, color, date, date and time, URL and JSON.
• References: to a product, variant, collection, page, file or metaobject entry.
• Lists of most of the above, such as a list of related products or a list of files.

Choosing the right type matters. A dimension or weight type stores a unit along with the number, and a product reference type stays linked even if the product's title changes. Plain text can't do either.

What metaobjects are

Shopify's Help Center explains: "If your data is best represented by multiple fields, you can use a metaobject to create an object with multiple fields." A metaobject has two parts:

• A definition, managed in Settings > Custom data, which sets out the fields. For example, a "Designer" definition might have name, photo, bio and website fields.
• Entries, managed in Content > Metaobjects, which hold the actual content, such as one entry for each designer.

You then attach entries to products, collections or pages with a metaobject reference metafield. Update a designer's bio once and it changes on every product that references it. Shopify's own examples include product highlights, influencer profiles, FAQs and event appearances.

Metaobjects can also have their own web pages. If you give a definition storefront access and turn on web pages, each entry can be published as a page with its own template. Shopify lets you choose which fields become the page title and meta description in its search engine listing settings. This works well for designer, ingredient, location or lookbook pages.

Metafields vs metaobjects: when to use which

Category metafields and Shopify's product taxonomy

When you assign a product category, category metafields become available for that product. Shopify describes them as "product attributes that map to a specific product category." For clothing, Shopify gives size, neckline, sleeve length, fabric and color as examples. These category metafields "use metaobjects and metaobject entries for the values," so "Navy" is the same entry everywhere you use it.

Use category metafields before creating your own versions of the same attributes. They are standardized, they can be linked to product options (Shopify can show color options as swatches on product pages), and standard attributes are easier for channels such as Google and AI shopping assistants to interpret.

How to create and show metafields in your theme

1. Create the definition

Go to Settings > Custom data, choose the resource (for example, Products), and add a definition. Give it a clear name, pick the type, add validation (such as minimum and maximum values, or a list of allowed choices), and turn on storefront access if it needs to appear on your store.

2. Fill in values

The field appears on each product's admin page. For large catalogs, fill values in bulk with the bulk editor, a CSV import or an import app.

3. Connect it in the theme editor

Shopify's Help Center says: "If you have a theme that supports dynamic sources, then you can connect most metafields to your theme by using the theme editor." Open a product template, add a text, image or collapsible-row block, and click the dynamic source icon to choose your metafield. No code is needed, and the block shows each product's own value.

4. Use Liquid where needed

For vintage themes, or for layouts the editor can't produce (such as a full spec table), developers read values in Liquid, for example product.metafields.custom.fabric. Metaobjects referenced by a metafield can be looped through to render FAQs or size charts. Keep this code in a dedicated section or snippet so it survives theme updates. Our guide on customizing a Shopify theme without breaking it explains how.

Practical uses that pay off

• Specifications. Dimensions, weight, materials, compatibility and certifications as structured fields, shown in a consistent spec table.
• Size charts. One metaobject per chart, referenced by every product that uses it.
• FAQs. A metaobject with question and answer fields, attached as a list to products or collections.
• Badges and callouts. True/false metafields such as "made in USA" or "vegan" that switch icons on and off.
• Related products and bundles. Product list references for hand-picked recommendations.
• Collection content. Rich text metafields for an intro above the grid and a buying guide below it, without a separate template for every collection.
• Filters. Shopify's Search & Discovery app can build storefront filters from metafields and metaobjects as well as from options, tags and vendors.

Native custom data vs apps

A few years ago, most stores needed a metafields app. In 2026, the native tools cover most needs: typed definitions, validation, metaobjects, entry management, theme connection and bulk editing. Apps still make sense for:

• Very large bulk imports and exports, or syncing with a PIM or ERP system.
• Complex conditional display logic that you'd otherwise need custom code for.
• Specialized content such as product comparison tables or advanced size advisors.

Be aware that apps can also create their own metafields and metaobjects, and they have separate limits from yours. Uninstalling an app may leave its data behind or remove it, depending on how the app stores it, so check before you remove one.

Limits to know

From Shopify's developer documentation on metafield limits and metaobject limits, as of October 2026:

• Metafield definitions: up to 256 per resource type created by the merchant, with up to 50 pinned per resource type. Each app gets its own allowance.
• Value size: most metafield types are capped at 64 KB. JSON is capped at 128 KB, though apps that used JSON fields before 1 April 2026 keep the earlier 2 MB limit.
• Lists: up to 128 items, or up to 1,024 for metaobject reference lists.
• Metaobject definitions: 128 on Basic, Grow and Advanced, and 256 on Plus.
• Fields and entries: up to 40 fields per metaobject definition and up to 1,000,000 entries per definition.

SEO and AI visibility uses

Metafields don't rank pages by themselves. What they do is help you publish more complete, consistent and structured content, which supports both search and AI channels:

• Unique on-page content. Specs, materials, FAQs and use cases make product and collection pages more useful, and less like the manufacturer's copy that dozens of other stores also use.
• Structured data. Developers can output metafield values (such as GTIN, brand, material or size) into product structured data, and FAQ content into the page itself.
• Filterable attributes. Clean attributes power filters that help shoppers find products. Be careful about letting search engines index every filter combination.
• Entity pages. Metaobject web pages for designers, ingredients or materials can target informational searches and link to the related products.
• AI shopping channels. Shopify Catalog syndicates product details to channels such as ChatGPT and Copilot. Shopify says Catalog "infers categories, extracts attributes, consolidates variants" from your data, so accurate categories and attributes give it better material to work with.

For more, see our guides to writing AI-friendly product pages and SEO best practices for Shopify, or browse the Shopify hub.

Common mistakes

• Storing structured data in product descriptions, where filters, themes and channels can't use it.
• Creating duplicate definitions (such as "material" and "fabric") for the same attribute.
• Using plain text for values that need units or references.
• Forgetting to turn on storefront access, then wondering why a field won't display.
• Building custom versions of attributes that category metafields already provide.

Conclusion

Metafields extend Shopify's records, and metaobjects give you reusable content types. Used together with category metafields and an Online Store 2.0 theme, they turn scattered product details into structured data that your theme, filters, search engines and AI channels can all use. Plan your definitions before you populate them, prefer standard category attributes, and keep values consistent. If you'd like a structured-data plan built around your catalog, eSEOspace's Shopify SEO services can help.

Frequently asked questions