Metafield Editor
The Metafield Editor is the single-resource workspace in Metafield Studio. It's designed for small, focused tasks where you need to work with one resource at a time — a specific product, a collection, a page, or any other supported Shopify resource.
Unlike the Spreadsheet Editor or the Bulk Editor, which are built for working across many resources at once, the Metafield Editor gives you full control over a single resource's metafields in one place.
When to Use the Metafield Editor
The Metafield Editor is ideal for one-off tasks such as:
- Quickly adding or editing a metafield value on a single product or page
- Creating a new metafield definition for a resource type
- Updating SEO metadata for an individual resource
- Copying ready-to-use Liquid code for a specific metafield
- Reviewing all metafields attached to a single resource
If you need to update the same metafield across dozens or hundreds of resources, use the Spreadsheet Editor, Bulk Editor, or CSV Import instead. The Metafield Editor is meant for precision work, not bulk operations.
Creating Definitions
You can create new metafield definitions directly from the Metafield Editor without leaving the resource you're working on. When you create a definition, you set the:
- Namespace and key — the unique identifier for the metafield (e.g.,
custom.care_instructions) - Type — the data type such as single-line text, rich text, number, date, image, URL, boolean, and more
- Name and description — a human-readable label and optional description for the metafield
Definitions ensure that your metafields are structured and consistent across all resources of the same type. Once a definition exists, it appears automatically when editing any resource of that type.
Managing Metafields for a Resource
After selecting a resource, the Metafield Editor shows all metafields associated with it. From here you can:
- Add values to existing definitions that don't have data yet
- Edit values for metafields that are already populated
- Clear values to remove data from a metafield without deleting the definition
- Delete metafields that are no longer needed on that resource
The editor supports all Shopify metafield types including text, numbers, dates, booleans, colors, images, files, URLs, references, and lists.
Managing SEO Data
The Metafield Editor includes a dedicated section for managing a resource's SEO metadata. You can edit the:
- SEO title — the title tag that appears in search engine results
- SEO description — the meta description shown below the title in search results
This makes it easy to optimize individual products, collections, or pages for search engines without navigating to separate sections in the Shopify admin.
Copying Liquid Code
One of the most useful features of the Metafield Editor is the ability to copy base Liquid code for any metafield. For each metafield on a resource, you can copy a ready-to-use Liquid snippet that outputs that metafield's value on your storefront.
For example, if you have a metafield with the key custom.care_instructions on a product, the editor provides Liquid code like:
{{ product.metafields.custom.care_instructions.value }}
This saves you from having to look up namespace and key names or remember the correct Liquid syntax. Simply copy the snippet and paste it into your theme's Liquid template wherever you want the value to appear.
The Liquid code provided is a starting point. Depending on the metafield type (e.g., images, lists, rich text), you may need to wrap the output in additional Liquid tags or HTML for proper rendering. See the Tutorials section for detailed examples.
Summary
| Task | Metafield Editor |
|---|---|
| Create metafield definitions | Yes |
| Edit metafields on a single resource | Yes |
| Manage SEO title and description | Yes |
| Copy Liquid code for a metafield | Yes |
| Best for | One-off tasks, one resource at a time |