Shopify Category Metafields: What to Fill In and How

Published October 22, 2026

Last checked against Shopify's Help Center: October 22, 2026.

When you give a Shopify product a category, a new card appears on the product page: Category metafields. Fields like color, size, material or neckline, depending on what you sell. Many merchants leave it alone because it looks optional. This guide explains what those fields are, how they connect to variants, filters and swatches, which ones are worth filling first, and the fastest ways to fill them across a catalog.

What category metafields are

Shopify describes them simply: "Category metafields are product attributes that map to a specific product category" (Shopify Help: Metafields). They come from Shopify's Standard Product Taxonomy, the open-source classification that covers categories, attributes and values across more than 25 verticals. In the taxonomy they're called attributes; in your admin they're called category metafields.

Three things make them different from the custom metafields an app or developer might create:

They depend on the category. "When you assign a standard category, it unlocks a set of pre-defined category metafields" (Shopify Help: Adding category metafields). For Apparel & Accessories > Clothing > Clothing Tops > Shirts, Shopify's example fields are clothing size, neckline and sleeve length type. No category, no category metafields.
Values are shared entries, not free text. "Category metafields use metaobjects and metaobject entries for the values." Each field comes with default entries you can use as is or customize. An entry you add on one product becomes available to every product connected to that category metafield.
Some are filled in for you. Shopify says that, based on AI predictions, some category metafields are added by default and others are suggested, and that "relevant category metafields and values are also added based on your product details" (Shopify Help: Shopify's product taxonomy). Those suggestions are a starting point; check them, especially on best sellers.

Why they're worth filling

Shopify says category metafields "help make products more discoverable on your site, on marketplaces, and on search engines" (Shopify Help: Using category metafields). Concretely, filled-in values let you:

Build storefront filters. In the Search & Discovery app, add a filter and choose a category metafield such as Color, with swatches or images if you want them.
Show color swatches. Swatches work only on a variant option connected to a color category metafield, and your theme must support them (in the theme editor, the Variant picker block offers Circle, Square or None). Shopify notes Dawn needs its latest version.
Keep variant names consistent. Rename the entry "black" to "graphite" once and Shopify updates it everywhere that entry is used.
Report on attributes. Category metafields can be used as filters and dimensions in Shopify reports, for example top sellers by material.

What about AI shopping channels?

Be careful with claims here, because Shopify is. Its guide to optimizing products for AI platforms lists the details AI platforms consider: title, description, images, product type, vendor, collections, tags, barcode (GTIN, UPC or ISBN) and variants, including option names. Category metafields aren't named on that list.

They still help indirectly, in two ways Shopify does document:

Variant option names. Connecting an option such as Color or Size to a category metafield gives every product the same standardized option values instead of "Blk", "black " and "Noir". Option names are on Shopify's list, and the agentic listing quality view checks variant and option completeness, including unclear acronyms or numbers in names.
Classification. Shopify Catalog classifies products from your product information, and that classification "can differ from the product category set in your admin" (Catalog requirements). "Uncategorized products" are excluded from Catalog. Getting the category right is the first step, and the category is what unlocks these fields.

So treat category metafields as part of good product data, not as a switch that puts you in ChatGPT. The fields that matter most for AI channels are still the title, description, images, barcode and option names.

Which fields to fill first

You don't need every field on every product. A sensible order:

Fields that are also variant options, usually color and size. Connecting them standardizes option names and unlocks swatches and filters in one go.
Fields shoppers filter or ask about in your category: material, fit, age group, compatible device, pattern. If customers ask it in support emails, it belongs in a field.
Your best sellers first. Shopify suggests values automatically, so review the products that make money before filling the long tail.

Some things aren't supported yet. Shopify lists unit of measurement and dimension type attributes, and custom attributes, as not currently available, and notes some apps don't support attributes. If you need those, use a regular custom product metafield.

How to fill them on one product

From the Shopify Help Center:

In your Shopify admin, go to Products and open the product.
In the Category section, search for and select the most accurate category, or click through the levels.
In the Category metafields section, click a field, then pick an entry from the drop-down, add a new entry, or edit an existing one.
Click Save.

You can also manage entries centrally: go to Content > Metaobjects, pick the definition, and click Add entry (desktop only). Remember that editing an entry "updates everywhere that entry is connected", which is useful for renames and risky for typos.

How to fill them in bulk

The bulk editor

Shopify's steps for editing metafields in bulk:

Go to Products and select the products. Filter first (for example by product type) so the selection shares a category.
Click Edit products, then Columns.
In the Metafields section, choose the metafields to edit.
Edit values in the table and click Save. Fix any errors and save again.

Shopify warns that Microsoft Edge can cause errors here because of URL length limits, and recommends Chrome, Firefox or Safari. If you're setting categories at the same time, the bulk editor also has a Product category column. Our guide to setting categories in bulk covers that part.

CSV import

For large catalogs a CSV is often faster. Shopify's CSV guide says product metafields are supported in CSV import and export, with column headers like Fabric (product.metafields.shopify.fabric). The shopify namespace is the one category metafields use. Some practical notes from the same page:

Find a metafield's namespace and key under Settings > Custom data > Products.
For list-of-metaobject fields, values are metaobject handles separated by semicolons (for example blue; red) or GIDs, not display names.
To connect a product option to a category metafield, use the Option LinkedTo column with product.metafields.shopify.<attribute>.
Variant metafields aren't supported in product CSVs.
The Product Category column takes either the full breadcrumb or the category ID, not both.

Safest workflow: export a few products, fill the values in the exported file, import those few, check them in the admin, then do the rest. Keep the original export as a backup.

Connecting variant options to category metafields

This is where category metafields pay off most. You can add variants by connecting an option to "a category or product metafield of metaobject reference (list) type" (Shopify Help: Adding variants with metafields). Compatible metafields show a data source icon. Once connected, the option values fill in from the metafield's entries, and you can still add custom values.

To migrate an existing option, open it, click the data source icon and choose the category metafield. Shopify's add-metafields page warns that existing values are cleared when you connect a metafield (a dialog asks you to confirm on mobile), so try one product first and check its variants, prices and inventory afterwards. To undo, edit the option, click the metafield name and choose Disconnect; the option becomes a custom option again.

What happens if you change a product's category

Shopify says that when you change the category of a product that has category metafields, "your critical data is retained", but "category metafields without values or not connected to variant options aren't automatically added to the new category" (Shopify's product taxonomy). It also notes new categories might not be compatible with some sales channels, so check where a product is published before recategorizing it.

Checklist

Every active product has a specific product category (category metafields depend on it)
Color and size options on best sellers are connected to category metafields
Entries have clear names customers use ("Navy", not "NVY-02")
AI-suggested values reviewed on top products
Search & Discovery filters added for the attributes shoppers use
Titles, descriptions, barcodes and option names complete, since those are the fields Shopify says AI platforms consider

Where Surfaced fits

Category metafields live in your admin, so no outside scanner can see them. What a scan can see is the public data around them: titles, descriptions, images, alt text, barcodes and variant names. The free AI readiness checker checks those for any public Shopify store. Disclosure: Surfaced is our app. Inside your admin it finds uncategorized products, suggests Standard Product Taxonomy categories and applies fixes with undo. For category metafield values themselves, the Shopify steps above are the way to go.