Shopify Metafields: Complete Guide (2026)
Shopify saves every product, customer, and order using a fixed set of default fields — title, price, SKU, email, and fulfillment status. Metafields are how you go beyond those defaults. They let you attach any additional data to any Shopify resource: a burn time to a candle product, a customer’s preferred communication method, a special handling instruction on an order, an expiration date on a grocery item.
If you’ve ever wanted to display information on your storefront that Shopify’s standard fields don’t support, automate workflows using data that isn’t captured natively, or build richer customer and product profiles, metafields are the way to do it.
This guide covers what metafields are, how they’re structured, how to create and manage them without code, how to automate them with MESA, the best apps for bulk editing and management, and when to use metafields versus metaobjects.

In this article:
What are Shopify metafields?
Metafields are custom key-value pairs that you can attach to Shopify resources — products, product variants, collections, customers, orders, pages, blogs, and the store itself. According to Shopify’s official documentation, metafields let you store specialized information that isn’t typically captured in the Shopify admin for internal tracking or display on your storefront.
The simplest way to think about a metafield: it’s a labeled container you define, attached to a specific resource, holding a specific type of data. A candle store creates a metafield called burn_time on their product, stores the value 40 hours, and can then display it on the product page through their theme. A grocery store creates an expiration_date metafield on products and uses it to trigger inventory alerts before items expire.
Metafields differ from Shopify’s standard fields — Title, Description, Price, SKU, Weight — which are fixed and cannot be removed or renamed. Metafields are entirely custom and optional.
Metafields vs. metaobjects: understanding the difference
Shopify has two custom data tools that serve different purposes and are often confused.
A metafield adds a single custom field to an existing Shopify resource. A product metafield for material attaches one data point to each product. If you need five related data points on a product — material, weight, dimensions, country of origin, care instructions — you create five separate metafields.
A metaobject is a structured, standalone object with multiple fields that you define once and reference repeatedly. A “staff member” metaobject might have fields for name, photo, title, and bio. You create one entry per staff member, then reference those entries from product pages (“meet the maker”), collection pages, or anywhere in your theme. Metaobjects are the right tool when you’re creating structured content with multiple related fields that need to be reused across your store.
For most day-to-day product, customer, and order data use cases, metafields are the right tool. When you find yourself wanting to create a consistent data structure that spans multiple storefront locations, consider using metaobjects instead.
How metafields are structured
Every metafield has three required components:
Namespace — a container that groups related metafields together and prevents naming conflicts with other apps. For example, custom is the default namespace Shopify uses for merchant-created metafields. You might use shipping to group delivery-related fields or seo to group search optimization fields. Namespaces also establish ownership — app-created metafields use the app’s reserved namespace so they don’t conflict with your own.
Key — the unique identifier within the namespace that names the specific field. Within a custom namespace, you might have keys like burn_time, care_instructions, or author_name. The namespace and key together form the field’s unique identifier — custom.burn_time.
Value — the actual data stored in the field. The value type is constrained by the content type you define when setting up the metafield definition.
Shopify metafield content types
The source articles described only four data types — string, integer, boolean, JSON — but Shopify’s current type system is substantially richer. Types are organized into categories:
Basic types — single-line text, multi-line text, integer, decimal, true/false (boolean), date, date and time, URL, color, weight, dimension, volume, rating.
Reference types — file reference, page reference, product reference, product variant reference, collection reference, metaobject reference. These link a metafield to another Shopify resource or object rather than storing a raw value.
List types — any of the above can be configured as a list to store multiple values in a single metafield. A product with multiple related products can store all of them in a list.product_reference metafield rather than requiring a separate field per related product.
Measurement types — weight, dimension, and volume have dedicated types with unit validation, ensuring stored values are always in a recognized measurement format.
The breadth of available types matters for automation: MESA workflows can read and write metafield values of any type, enabling use cases like updating a date metafield to trigger time-based workflows, or reading a rating metafield to automatically route products into different collection assignments.
For the full current list, see Shopify’s metafield content types documentation →.
Standard metafield definitions
Shopify provides pre-built “standard” definitions for common use cases — ISBN numbers, product ingredients, care instructions, allergen information, product materials, and more. These are ready-made schemas that you can apply to your products without defining the structure yourself.
Standard definitions are worth using when they match your use case because they ensure interoperability with the Shopify ecosystem — other apps, Shopify’s own product categorization system, and external channels can recognize and use standardized fields in ways they can’t with custom field names.
For example, if you sell apparel and use Shopify’s standard definitions for size, fabric type, and care instructions, those values map automatically to Shopify’s category metafields — making products more discoverable on search engines and marketplaces.
How to create metafields in Shopify (without code)
Shopify’s admin provides a full native interface for creating and managing metafield definitions — no apps or API access required for most use cases.
Navigate to Settings > Custom Data in your Shopify admin. You’ll see a list of resource types: Products, Product Variants, Collections, Customers, Orders, and more. Select the resource type you want to add a metafield to, then click “Add definition.”
For each definition you’ll set: a name (which auto-generates the namespace and key), a content type, an optional description, and optional validation rules — for example, constraining a numeric field to a minimum and maximum value range.
Once a definition exists, metafield values can be added to individual resources directly from their edit pages in the admin. A product’s edit page will display all product metafield definitions at the bottom, ready to fill in.
Limitations of the native admin:
Bulk editing metafields from the admin is not supported. If you need to set a metafield value across hundreds or thousands of products simultaneously, you need either a third-party app or MESA automation. Similarly, importing and exporting metafields from the native admin is not possible — both require a third-party tool.
See Shopify’s official documentation: Creating custom metafield definitions →
How to automate Shopify metafields with MESA
Automating metafields means setting, updating, or reading metafield values as part of a workflow — without manual data entry. MESA connects metafield read and write operations to any trigger event in Shopify or connected apps.
Tag products based on a metafield value
When a product’s metafield value meets a condition — a rating drops below a threshold, a date field passes a deadline, a boolean field is set to true — MESA can automatically tag the product, move it to a collection, or trigger any other downstream action. This is the foundation of a data-driven product organization that doesn’t require manual review.
MESA template: Tag Shopify products with metafield values
Add customer metafields to order notes
Customer metafields often contain information that fulfillment teams need — preferred shipping instructions, company names for B2B orders, account tier, VIP status. MESA can automatically copy relevant customer metafields into the order notes field when an order is created, making that data immediately visible in the fulfillment workflow without anyone having to cross-reference the customer record.
MESA template: Add customer metafields to Shopify order notes
Update order metafields with customer company name
For B2B merchants, automatically populating the order metafield with the customer’s company name enables downstream workflows that depend on knowing which organization placed the order — routing to specific fulfillment logic, generating B2B invoices, or filtering reports by company.
MESA template: Update Shopify order metafield with customer company name
Schedule product collection changes by metafield date
When products have a date-based metafield — a sale start date, a seasonal availability window, a product launch date — MESA can monitor those dates and automatically move products into or out of collections when the date arrives. A product tagged for a limited-time promotion is added to the “On Sale” collection on the start date and removed on the end date without any manual intervention.
MESA template: Schedule product collection changes by metafield date
Sync loyalty points to a customer metafield
When a customer earns Yotpo loyalty points, MESA can write that balance to a customer metafield — creating a Shopify-native record of loyalty status that other apps and workflows can read without making a separate API call to Yotpo.
MESA template: Update Shopify customer metafield with Yotpo loyalty points
Auto-generate SEO meta titles and descriptions
MESA’s AI integration can automatically generate SEO-optimized title tags and meta descriptions for new products, applying consistent SEO standards across your catalog without manual copywriting for each product.
MESA template: Auto-generate SEO meta titles and descriptions for new Shopify products
Generate product tags with AI
Using product metafield data — materials, categories, attributes — MESA can trigger an AI step that generates relevant product tags automatically and applies them to the product, keeping your tag taxonomy consistent without manual review.
MESA template: Use AI to generate Shopify product tags
The best Shopify metafield management apps
The native Shopify admin handles individual metafield entry well but doesn’t support bulk operations, CSV import/export, or complex field management across large catalogs. These apps fill that gap.
Metafields Guru
Metafields Guru is the most widely reviewed metafield management app on the Shopify App Store, with a 4.9 rating and a reputation for reliable bulk operations and strong customer support. Its Excel-like spreadsheet interface makes bulk editing familiar and accessible — you can create, update, and delete metafields across thousands of products in a single operation. CSV import and export work with files of any structure, making data migration between stores or from external systems straightforward. It also includes a browser extension that lets you manage metafields directly in the Shopify admin panel, without having to navigate to a separate app.
Best for: merchants managing large catalogs who need reliable bulk editing, CSV import/export, and data migration between stores.
Accentuate Custom Fields
Accentuate has expanded well beyond basic metafield management and is now positioned as a multi-app platform that combines metafields, metaobjects, theme blocks, filtering, bulk editing, and automatic translations. It carries a Built-for-Shopify badge, indicating it meets Shopify’s highest standards for performance and integration. Its theme block system lets you add custom data to storefront pages through the theme editor without code. It supports bulk import/export via Excel and can sync metafield definitions across multiple stores.
Best for: merchants who want a single app handling both metafield management and storefront display, with strong support for metaobjects and multilingual stores.
Bonify Custom Fields
Bonify is the original custom fields app for Shopify and remains a highly capable option for merchants who need complex field structures. Its widget system integrates with the Shopify theme editor, and it supports nested field groups — a structure where multiple related fields are organized together — that simpler apps don’t offer. The Chrome extension allows direct metafield editing within the Shopify admin without switching to the app interface. Bonify also has an eBay connector, making it particularly useful for merchants managing product data across Shopify and eBay simultaneously.
Best for: merchants who need complex nested field structures, eBay integration, or an established app with a long track record.
ACF: Metafields Custom Fields
ACF supports all Shopify metafield data types through an accessible interface and is frequently cited for fast, responsive support. It handles bulk import and export, liquid syntax retrieval for theme developers, and covers the full range of data types, including color picker, date and time, files, references, and JSON. A free plan is available, making it accessible for merchants who want to test metafield management before committing to a paid tool.
Best for: merchants who want broad data type support, responsive support, and a free entry point.
Hulk Custom Fields Metafields
HulkApps’ metafield app supports bulk import and export (via product ID or handle), multiple field types including image and file uploads, dynamic logic for conditional field display, global metafields, and multiple display templates. The Pro+ plan adds Shopify Flow automation integration and scheduled backups — making it one of the few metafield management apps that connects directly to Flow without requiring a separate automation platform. A free plan is available.
Best for: merchants already invested in the HulkApps ecosystem who want Shopify Flow automation connected to metafield management, or merchants who need scheduled backup functionality.
Metafields for SEO
Metafields can meaningfully improve organic search performance when used intentionally for two purposes.
The first is enriching product data that feeds into structured markup. Category metafields — the standardized fields Shopify maps to product categories — populate the data that search engines use for rich results: size, material, fabric type, care instructions. Stores that fill these fields thoroughly produce more complete structured data, which improves how products appear in Google Shopping results and category-filtered search queries.
The second is generating consistent SEO metadata at scale. Product meta titles and meta descriptions are often neglected on large catalogs because writing them manually for hundreds of products is time-prohibitive. MESA’s AI integration can generate these automatically using product data, including metafield values, creating a consistent SEO standard across the catalog. The MESA template for this — Auto-generate SEO meta titles and descriptions for new Shopify products — fires whenever a new product is created, ensuring new additions are optimized by default.
Frequently asked questions
A Shopify metafield is a custom data field you can attach to Shopify resources — products, variants, customers, orders, collections, pages, and the store itself — to store information beyond Shopify’s default fields. Metafields are defined by a namespace, a key, and a content type, and their values can be displayed on your storefront, used in automation workflows, or stored for internal tracking. See Shopify’s official metafields documentation at help.shopify.com/en/manual/custom-data/metafields.
A metafield adds a single custom field to an existing Shopify resource. A metaobject is a standalone structured object with multiple fields that you define once and reference from multiple locations. Use metafields to store individual data points for existing resources. Use metaobjects when you need to create repeatable content structures — team members, FAQs, specifications — with multiple related fields per entry.
No. Shopify’s native admin (Settings > Custom Data) lets you create metafield definitions and fill in values without any code. For displaying metafield values on your storefront, Online Store 2.0 themes support connecting metafields to theme sections through the theme editor without code. For bulk editing, CSV import/export, or complex management across large catalogs, third-party apps like Metafields Guru or Accentuate handle everything without coding knowledge.
Not from the native admin — Shopify doesn’t currently support bulk metafield editing in the admin interface. Bulk editing requires either a third-party app (Metafields Guru and Bonify both excel at this) or a MESA automation workflow that reads a data source and writes metafield values programmatically across multiple records.
Yes, but not from the native admin. Both Metafields Guru and Bonify support CSV import and export for metafield data. MESA can also read metafield values from Shopify and push them to Google Sheets, or pull data from an external source and write it to metafields as part of an automation workflow.
MESA can read metafield values as conditions in workflow logic — “if the product’s availability metafield equals ‘pre-order’, route the order differently” — and write metafield values as workflow actions — “when an order is created, copy the customer’s account_tier metafield to the order notes.” This makes metafields a data layer that MESA workflows can both read from and write to, enabling automation logic that Shopify Flow can’t handle natively because Flow has limited access to metafield data.
Shopify supports up to 256 app-defined metafield definitions and 256 merchant-defined metafield definitions per store, with up to 1 million entries per definition. These limits were increased significantly in a recent platform update. For most merchants, these limits are not a practical constraint.
Yes. Shopify Flow can use metafield values as conditions in automation triggers and can update metafield values as automation actions. For automations that involve metafields alongside apps outside the Shopify ecosystem — pushing a metafield value to an external CRM, reading a metafield to determine Klaviyo list membership, or writing metafield values based on events in Recharge or Yotpo — MESA provides the integration layer that Flow doesn’t have.
Next steps
Metafields are most powerful when they feed into automation rather than sit as static data. The highest-impact starting points are order metafields that carry customer context into fulfillment workflows, and product metafields that drive dynamic collection membership and SEO metadata.