---
title: "How to edit Shopify metafields in bulk: product, variant and list metafields (2026)"
url: https://www.ablestar.com/blog/shopify-metafields-bulk/
date: 2026-10-21
lastmod: 2026-10-21
description: "The native ways to change metafields on many Shopify products at once, where each one stops, and how to add to lists, copy values, delete metafields and handle rich text, reference and measurement types in bulk."
categories: ["Articles","Tips \u0026 Tricks"]
---


To edit metafields on many Shopify products at once, create a metafield definition first, then select the products in **Products**, click **Edit products**, open **Columns** and add the metafields under **Metafields**. You type a value per product and click **Save**. Product CSV import also supports product metafields, as columns like `Material (product.metafields.custom.material)`. Both ways write exactly the value you give them. To add one value to a list without replacing it, copy a value from another field, edit only the products that match a filter, or undo a change, you need an app.

This guide covers what metafields and definitions are, the native ways to edit them in bulk and where each one stops, and how to do the common jobs: lists, copies, deletes and the harder types.

## What are metafields and metafield definitions?

A **metafield** stores extra information on a product, variant, collection or customer: a material, care instructions, a size chart, a list of features. A **metafield definition** tells Shopify the name, the type (text, number, list of text, reference, rich text and so on) and the rules for the values. You create definitions under **Settings > Metafields and metaobjects**, or from the **Metafields** section of a product page with **Add definition**.

Most bulk tools need the definition. Shopify's bulk editing support, added in 2022, is for "Product metafields with definitions", and apps like Bulk Product Editor list only metafields that have one. Metafields without a definition can't be edited in the Shopify admin, so if your store has some, create a definition for them first.

**Product metafields** have one value per product. **Variant metafields** have one value per variant and live in a different place in the admin; see [variant metafields in bulk](/blog/shopify-variant-metafields-bulk/) for the details.

A few Shopify limits apply to every store: 256 definitions per resource type, 50 pinned definitions that show on the admin pages, and 128 values in a list metafield (1,024 for lists of metaobject references).

## How do you edit metafields in Shopify's bulk editor?

1. In **Products**, select the products. Use the filters and search on the product list to narrow them down first.
2. Click **Edit products**, then **Columns**.
3. In the **Metafields** section, pick the metafields to edit.
4. Type or paste a value in each cell and click **Save**.

Shopify's help says bulk editing works for product, variant, collection and customer metafields. Variant metafields need the variant bulk editor, which you open with a link; the [variant metafields guide](/blog/shopify-variant-metafields-bulk/) shows how.

{{< media border="true" src="/uploads/2026/10/shopify-variant-bulk-editor-metafield-columns.png" alt="Shopify bulk editor with the columns Title, SKU, Google: MPN and Google: Size System" caption="Shopify's bulk editor with two metafield columns. Each cell is saved exactly as typed." >}}

The bulk editor is good for a few hundred products when you know each value. It stops here:

- **No rules.** You can't say "add this to the end", "copy the value from another field" or "replace this word". Each cell gets what you type.
- **Lists are one value per product.** There's no way to add one item to the lists of many products; each product's list is edited on its own.
- **No undo** after you click **Save**.

## Can you update metafields with a CSV file?

Yes for product metafields, no for variant metafields. Shopify's product CSV accepts columns named `<name> (product.metafields.<namespace>.<key>)` or just `product.metafields.<namespace>.<key>`. The easiest way to get the right headers is to export a few products with those metafields and edit that file.

Some limits to know before you start:

- **Not every type is supported.** Shopify's list of CSV types includes text, numbers, dates, colors, measurements, money, URLs, product references and lists of metaobject references. Lists of text, rich text, JSON and file references are not on it.
- **List values** in Shopify's examples are separated with semicolons, like `#ff00cc; #cc0000`.
- **References** take a handle or an ID, for example a product handle or `gid://shopify/Product/123`.
- **Rows match by URL handle**, and a blank cell in a column you include overwrites the value with a blank. Keep only the handle and the metafield columns you want to change. The [spreadsheet guide](/blog/update-shopify-products-from-spreadsheet/) explains how the import decides what to overwrite.
- **Variant metafields** aren't supported in the product CSV at all.

## Can Shopify Flow update metafields?

Flow has an **Update product metafield** action and a **Remove product metafield** action. Both work on the product that triggered the workflow, with triggers like **Product added to store** or **Product status updated**. That's good for keeping a value up to date as products change. For a one-time change to products you already have, you need a workflow that runs on a schedule and loops over the products, which takes some setup.

## How do you set or copy a value on many products?

For one value on every product, the bulk editor works if you paste it into each cell. It gets harder when each product needs its own value built from its other fields, like a metafield that repeats the vendor, or a search keyword made from the title and the product type.

In [Ablestar Bulk Product Editor](https://apps.shopify.com/bulk-product-editor), you filter the products, pick the metafield under **Field to edit** (in the **Product metafields**, **Variant metafields** or **Category metafields** group), and choose **How to edit**. Text metafields have **Set text to value**, **Add text to end**, **Find and replace**, **Change capitalization** and more. **Add dynamic value** inserts another field, so `{{ product.vendor }}` or `{{ product.metafields.custom.material }}` gives each product its own value. See [dynamic values](https://support.ablestar.com/article/35-editing-product-fields-using-placeholders-from-other-fields).

{{< media border="true" src="/uploads/2026/10/bulk-product-editor-variant-metafield-from-sku.png" alt="Ablestar Bulk Product Editor edit of a metafield set to a dynamic value, with a preview where every row gets its own value" caption="A metafield set from another field. The preview shows the new value for every product and variant before anything changes." >}}

## How do you add a value to a list metafield without replacing it?

A list metafield, like a list of features or compatible models, is saved as one value in Shopify. The bulk editor and the CSV both replace the whole list, so adding one item means rewriting every list by hand.

In Bulk Product Editor, list metafields have their own options:

- **Add item to the end of the list** (or the start) adds one value and keeps the others. If a product already has that value in its list, Shopify rejects the duplicate for that product, and the edit log shows it.
- **Remove item(s) from the end of the list** (or the start) removes a number of items from that end.
- **Find and replace** changes text inside the items. With an empty replacement it removes an item, but it matches text inside each item, so removing `Cotton` also changes `Organic Cotton`. Check the preview.
- **Set from prefixed tags** fills a list from tags like `Feature=Waterproof`; see [converting prefixed tags to list metafields](https://support.ablestar.com/article/220-converting-prefixed-tags-to-list-metafields-in-shopify) and the [tags guide](/blog/shopify-product-tags-bulk/).

The options are in [editing list of text metafields](https://support.ablestar.com/article/266-how-to-edit-list-of-text-string-metafields). A few list types, such as lists of numbers, can't be edited in the app yet; the app shows a notice when you pick one.

## How do you remove a metafield from many products?

Shopify's bulk editor has no "remove from all" action, and Flow's **Remove product metafield** works one triggering product at a time.

In Bulk Product Editor, pick the metafield and choose **Delete metafield** (for metaobject references it's **Delete reference**). It removes the metafield from every product in the filter, so the field shows as empty again. An edit that would leave the value empty also deletes the metafield instead of saving a blank. In a spreadsheet edit, an empty cell is skipped and a cell with `delete` deletes the metafield, so you can't clear values by accident. See [bulk deleting metafields](https://support.ablestar.com/article/229-bulk-deleting-metafields-in-shopify).

## How do you edit rich text, reference, JSON and measurement metafields?

These types need a specific format, which is where bulk edits fail most often.

- **Rich text** is saved as JSON, not HTML, and it isn't on Shopify's list of CSV types. In Bulk Product Editor you write it in a text editor that allows a limited set of HTML tags, and the app converts it. **Find and replace** works on the text inside, with a **Case-insensitive search** option. See [rich text metafields](https://support.ablestar.com/article/186-rich-text-metafields).
- **Product, variant, collection and page references** take a handle or an ID in the app and in its spreadsheets, and the app looks up the ID. See [product reference metafields](https://support.ablestar.com/article/242-product-reference-metafields).
- **Metaobject references**, like a size chart or a care guide entry, take the entry's handle or its display name. See [metaobject references](https://support.ablestar.com/article/230-bulk-editing-metaobject-references-in-shopify) and [metaobject lists](https://support.ablestar.com/article/274-editing-metaobject-lists).
- **File references** take a file name from **Content > Files** or a URL. A URL from outside Shopify is uploaded to your files first. See [file reference metafields](https://support.ablestar.com/article/316-editing-file-reference-metafields).
- **JSON** must be valid JSON. The app checks it before the edit runs ("Valid JSON required").
- **Weight, dimension and volume** need a number and a unit. In the app you type the number and pick the unit. In a spreadsheet you write `12 cm` or `1.5 kg`, which is also how the app exports them, so an export can be edited and imported again. See [dimension metafields](https://support.ablestar.com/article/125-editing-dimension-metafields-with-a-spreadsheet).
- **Multi-line text** has the same options as single-line text.
- **Category metafields** (like color or fabric from Shopify's product taxonomy) are in their own group; see [category metafields](https://support.ablestar.com/article/278-editing-category-metafields) and the [product categories guide](/blog/shopify-product-categories-bulk/).

When Shopify rejects a value, for example a value that isn't in the definition's list of choices, the edit log shows an error code with the reason. See [error codes](https://support.ablestar.com/article/311-error-codes).

## How do you find products with a missing or specific metafield value?

In Shopify, turn on **Use as filter in admin** in the metafield definition. Then you can filter the product list by that metafield's value, or search with a query like `metafields.custom.material:cotton`. A store can turn this on for up to 50 product definitions. Product and variant metafields can also be smart collection conditions when the definition allows it.

In Bulk Product Editor, **Add filter** has **Product Metafields**, **Variant Metafields** and **Category Metafields** groups for every definition. Text metafields can be filtered with **contains**, **equals** and **is not set**, numbers with **is greater than** and **is less than**, and every type with **is set** and **is not set**. "Show me products with no care instructions" is the **is not set** filter, and the edit then changes only those products. A filter on a variant metafield returns only the matching variants. See [search and filters](https://support.ablestar.com/article/38-search-tips-for-bulk-product-editing-).

## How do you update metafields from your own spreadsheet?

With **Spreadsheet edit** in Bulk Product Editor, you upload your own CSV or Excel file and pick the column that identifies each row: SKU, barcode, variant ID, product ID or handle. So a supplier file with only SKUs works. Map each column to a metafield in the **Product Metafields** or **Variant Metafields** group. List cells can be a JSON array, one value per line, or values separated with `|` or commas. Exports from the app use the definition name as the column header. See [bulk editing metafields](https://support.ablestar.com/article/73-bulk-editing-shopify-metafields) and [editing products by spreadsheet](https://support.ablestar.com/article/23-editing-products-by-spreadsheet).

## How do you make metafield changes safely?

Metafields often feed the product page, filters on the storefront and feeds to other channels, so a bad bulk change shows up in many places. Work in this order:

1. Filter down to the products you mean to change, and check the count.
2. Check the new values before you save. In Bulk Product Editor the preview shows the old and new value for every product before you click **Run edit**.
3. Run it on a few products first, then on the rest.
4. Keep a way back. In Bulk Product Editor, **Undo** on the edit's page puts back the values from before the edit. See [undoing an edit](https://support.ablestar.com/article/39-undoing-a-product-edit) and [how to undo a bulk edit in Shopify](/blog/undo-bulk-edit-shopify/).

## Which way should you use?

| | Shopify bulk editor | Product CSV | Flow | Bulk Product Editor |
| --- | --- | --- | --- | --- |
| Product metafields | {{< yes >}} | {{< yes >}} | One product per run | {{< yes >}} |
| Variant metafields | With a link | {{< no >}} | One variant per run | {{< yes >}} |
| Add to a list without replacing it | {{< no >}} | {{< no >}} | Build it yourself | {{< yes >}} |
| Value from another field | {{< no >}} | {{< no >}} | {{< yes >}} | {{< yes >}} |
| Delete a metafield on many products | {{< no >}} | {{< no >}} | One product per run | {{< yes >}} |
| Rich text, JSON, file references | Not documented | {{< no >}} | {{< yes >}} | {{< yes >}} |
| Filter by metafield value | With admin filter on | {{< no >}} | Conditions | {{< yes >}} |
| See changes before saving, undo after | {{< no >}} | {{< no >}} | {{< no >}} | {{< yes >}} |

- **A few products:** edit the metafields on each product page.
- **A few hundred products with values you know:** use Shopify's bulk editor.
- **A file you already have, with supported types:** the product CSV works for product metafields.
- **Lists, copies between fields, deletes, many variants, or a change you may want to take back:** use an app.

Metafield edits, filters, previews and undo are on every plan of Bulk Product Editor. The free plan edits up to 10 products per edit, and Basic ($30/month) removes the limit. See [all plans](https://support.ablestar.com/article/41-bulk-product-editor-sync-plans).

{{< cta url="https://apps.shopify.com/bulk-product-editor" label="Try Ablestar Bulk Product Editor" >}}

## Frequently asked questions

### Why doesn't my metafield show up in the bulk editor or in an app?

It probably has no definition, or the definition is for a different resource (variant instead of product). Add or check the definition under **Settings > Metafields and metaobjects**. In Bulk Product Editor, new definitions arrive on their own; if one is missing, use **Refresh** under **Settings > Metafields**.

### Does a blank cell delete a metafield?

In Shopify's product CSV, a blank cell in a column you include overwrites the value with a blank, so leave out columns you don't want to change. In a Bulk Product Editor spreadsheet edit, blank cells are skipped, and you write `delete` in a cell to delete that metafield.

### How many values can a list metafield hold?

Up to 128 values, or 1,024 for a list of metaobject references. A definition can set a lower limit.

### Can I edit metafields with Sidekick?

If Bulk Product Editor is installed, Sidekick can prepare a Bulk Product Editor edit for text, number, date, true/false and text list metafields, and you open the preview and click **Run edit** yourself. See [using Sidekick with Bulk Product Editor](https://support.ablestar.com/article/336-feature-7-sidekick-ai-to-help-your-workflow).

{{< interstitial slug="how-to-bulk-edit-shopify-products" >}}