# Shopify Category Metafields: From Import to Product Page

> Importier fills category metafield values through Industry Packs. Displaying them on the Shopify product page takes one theme configuration step.

- Published: 2026-09-17
- Author: Importier Team
- Category: Store Management / SEO & Discoverability
- Canonical: https://www.importier.app/blog/shopify-category-metafields-product-page

---

A stationery merchant imports 200 products from a supplier spreadsheet through Importier's Office and School Supplies Industry Pack. Shopify category metafields for Paper Format, Page Count, Binding Type, and Ruling Style are all correctly filled through two-phase attribute matching. The import completes without errors. The merchant clicks through to the live product page on their storefront. The structured attributes are nowhere on the page.

The products are correctly configured. The category metafield values are in Shopify's database exactly where they should be. The issue is that Shopify themes do not display metafields automatically; displaying them requires a separate step in the theme editor. This is the part that catches most merchants who are new to category metafields.

## What Importier Stores When It Sets Category Metafields

Importier's Industry Packs map to [Shopify's Standard Product Taxonomy](https://help.shopify.com/en/manual/products/organizing-products/product-taxonomy), a hierarchical classification system with 22 top-level categories, hundreds of sub-categories, and 3,758 defined attribute types. When a merchant runs an import using an Industry Pack, Importier fills the appropriate attribute values for each product using two-phase matching: first a text match against the supplier data, then an AI match for attribute values that do not have an obvious text equivalent in the source file.

The result is stored as structured Shopify metafields in the `shopify` namespace. These are not free-form custom metafields; they use Shopify's taxonomy attribute keys, which means they integrate directly with the platform's structured data layer. Google Shopping feed attributes, AI shopping agent compatibility checks, and Shopify's own search and filtering infrastructure all read from this same namespace.

To confirm the values are correctly set after an import, open Shopify admin, navigate to a product, scroll to the Metafields section at the bottom of the product detail page, and look for the taxonomy attributes. If the import worked, they are populated there, visible in the admin even before any theme configuration.

<Callout label="Admin vs storefront">
Metafield values are visible in Shopify admin (Products → [product] → scroll to Metafields) immediately after import. Storefront visibility depends on whether the theme has been configured to show them. These are two separate states; admin visibility does not imply storefront visibility.
</Callout>

## Why Category Metafields Do Not Appear on the Storefront

Shopify separates data storage from data presentation. Metafields store structured values in the database. Themes control which values appear on the product page and in what format. This separation is intentional, since different merchants display product data differently depending on their audience, their theme design, and which attributes are relevant to their category.


![Data analyst at a desk with a large printed product taxonomy spreadsheet showing colour-coded attribute column headers and row entries for product specification categories, reference binders beside the spreadsheet](/blog/shopify-category-metafields-product-page/01.jpg)


When Shopify introduced its Standard Product Taxonomy and the associated metafield system, it also added a Product Metafields block to Online Store 2.0 themes. This block reads the taxonomy attribute values from the `shopify` namespace and renders them in Shopify's standard two-column pill layout: attribute name on the left, values as pills on the right.

Themes that support this block include Dawn, Craft, Refresh, Sense, and Spotlight, covering all of Shopify's official themes since the OS 2.0 release. Older Shopify 1.0 themes (those built before OS 2.0, or third-party themes that have not been updated) do not include this block by default. For those themes, the metafield display requires either a theme update or a custom Liquid snippet.

The merchant with the stationery products has the values correctly stored. They need one more step: adding the Product Metafields block to their theme template.

## Adding the Product Metafields Block to Your Theme

This is a one-time configuration per theme. Once added, every product page shows its taxonomy attributes without any per-product work.

<Steps items="In Shopify admin, go to Online Store, then Themes, and click Customise on your active theme | Use the sidebar navigation to find the product template. In most themes this is listed as Products then Default Product or Products then All Products | Click on the product template body. Look for the Add section or Add block option (the exact label depends on the theme). Search for Product Metafields in the component library | Add the block. In themes like Dawn, it appears as a separate section that shows all taxonomy attributes from the shopify namespace for the current product. Place it below the product description and above shipping/returns content | Save the theme. The attributes now appear on every product page that has category metafield values set. Products without metafield values show no empty rows" />

The entire setup takes under five minutes. From this point, any product that Importier imports with category metafields populated shows those attributes automatically on the product page.

<Divider label="From data to display" />

## What Category Metafields Look Like on the Product Page

Once the Product Metafields block is added, Shopify renders the taxonomy attributes in a structured two-column layout. The attribute name appears on the left, and the values appear as pills on the right. For a notebook from the stationery import:

- **Paper Format** | A4 &nbsp; A5
- **Page Count** | 100 sheets
- **Binding Type** | Spiral-bound
- **Ruling Style** | Ruled

Each attribute that has a value populates a row. Attributes without values do not appear. The layout is consistent across all products in the catalogue and all 22 Industry Packs; a sporting goods pack produces the same structured layout as a stationery pack, just with different attribute names.

![UX designer at a drafting table with printed product page wireframe templates showing structured block layouts with labelled content modules arranged as cut-paper panels on drafting paper](/blog/shopify-category-metafields-product-page/02.jpg)

<PullQuote>The taxonomy attribute layout is the same across all 22 Industry Packs. A sporting goods product and a stationery product both render in Shopify's two-column pill format; the attributes differ but the presentation does not.</PullQuote>

This consistent presentation matters for merchant credibility. Shoppers reading the stationery product page see structured, comparable attribute data, not a paragraph that reads "available in A4 and A5 sizes, 100 sheets, spiral bound, ruled" buried somewhere in the description.

## Multi-Value Attributes and Pill Display

Some category attributes support multiple values. Camera filters can fit multiple thread sizes. A notebook can be available in multiple ruling styles. A running shoe can carry multiple certifications. Importier's multi-value support handles these cases at import time: a supplier cell that reads "49mm / 52mm / 67mm" for Compatible Filter Thread Size gets parsed into three separate values, each stored as a distinct taxonomy entry.

On the product page, multi-value attributes render as separate pills side by side:

**Compatible Thread Size** | 49mm &nbsp; 52mm &nbsp; 67mm

Each pill is a distinct, machine-readable value. An AI shopping agent comparing filter compatibility reads the structured pills, not a pipe-separated string buried in the description. Google Shopping feed validation reads each pill value independently against the permitted values for that attribute type, so a correctly populated multi-value attribute passes review without manual correction.

Importier's two-phase matching identifies multi-value attributes during import. The AI matching phase is particularly useful here: attributes with non-standard separators (semicolons, slashes, commas) in supplier data are correctly split and mapped to individual taxonomy values.

For more on the difference between Shopify's category metafields and standard product metafields, see [Shopify Product Metafields vs Category Metafields](/blog/shopify-product-metafields-vs-category-metafields), which covers when to use each type and how they appear differently on the product page.


![Shopkeeper at a wooden retail table comparing two spiral-bound notebook products side by side with printed specification label cards in front of each notebook showing product attribute details](/blog/shopify-category-metafields-product-page/03.jpg)


## Which Industry Pack Attributes Appear on Your Product Page

Importier's 22 Industry Packs cover [Shopify's Standard Product Taxonomy](https://help.shopify.com/en/manual/products/product-metafields) from Apparel and Accessories through to Vehicles and Parts. Each pack maps the taxonomy attributes relevant to that product category. After import, only the attributes that the pack filled appear on the product page; the block does not show empty rows.

A few examples of what appears by pack:

- **Electronics and Technology Pack**: Connector Type, Display Size, Storage Capacity, Compatible Operating System, Resolution, RAM Capacity
- **Office and School Supplies Pack**: Paper Format, Page Count, Binding Type, Ruling Style, Paper Weight
- **Sports and Fitness Pack**: Sport, Material, Target Group, Age Group, Skill Level, Certification
- **Apparel and Accessories Pack**: Size, Colour, Material, Target Gender, Age Group, Closure Type

These match the attributes Shopify's Standard Product Taxonomy expects for each category. Importing a product without an Industry Pack (or outside an Industry Pack's coverage) means those taxonomy fields remain empty and nothing appears in the Product Metafields block for that product. The [Standard Product Taxonomy guide](/blog/shopify-standard-product-taxonomy) covers which Shopify taxonomy categories each Industry Pack maps to.


![Category manager at an office table with multiple printed industry reference binders open showing tabbed attribute lists for different product categories with coloured tab dividers and yellow notepad beside them](/blog/shopify-category-metafields-product-page/04.jpg)


<Compare withoutTitle="Spec paragraph in description body" withTitle="Category metafields via Importier" withoutItems="Specs typed into description as prose: readable by humans, ignored by structured data systems | No consistent format across products: format varies by whoever wrote the description | Not readable by Google Shopping feed: spec values in prose do not satisfy attribute requirements | Not filterable: Shopify collection filters cannot parse values from description text" withItems="Taxonomy attributes stored as structured metafields in the shopify namespace | Consistent across all 22 Industry Packs and 3,758 attributes: same two-column pill layout for every product category | Machine-readable: Google Shopping, AI shopping agents, and Shopify Search all read from the same structured namespace | Filter-ready: Shopify Search and Discovery can use metafield values to power product filters and faceted navigation" />

<TipBox />

## Key Takeaways

- **Importier fills category metafield values; your Shopify theme displays them.** These are two separate systems. The import sets the data in the `shopify` namespace. The theme controls whether and how that data appears on the product page.
- **Adding the Product Metafields block is a one-time configuration.** After you add it in the Shopify theme editor, every product with category metafield values shows its attributes automatically. Products without values show no empty rows.
- **Online Store 2.0 themes (Dawn, Craft, Refresh, Sense, Spotlight) support the block natively.** Older 1.0 themes require a theme update or a custom Liquid snippet to display the same data.
- **Multi-value attributes render as separate pills.** Compatible thread sizes, certification types, and compatible operating systems each appear as individual pills, machine-readable by Google Shopping and AI shopping agents.
- **Category metafield values are visible in Shopify admin under the product's Metafields section even before theme configuration.** If you want to verify the import worked, check admin first. If the values are there in admin but not on the storefront, the theme block is the missing step.

Import your products with category metafields through an Industry Pack at [importier.app](https://importier.app) and add the metafield display block once to show structured attributes across your entire catalogue.