SEO Guide · 2026

Shopify Metafield Types Reference: Complete Guide for AI Agent Visibility

Shopify's default product data model is deliberately minimal. Metafields are how merchants and developers extend it — and several specific metafield namespaces are read directly by AI shopping agents, Google Merchant Center, and Facebook Catalog Manager to disambiguate products and improve category matching.

All Shopify metafield types (2026)

Shopify supports 17 metafield types. The type controls validation, UI in the admin, and how the value is serialized in API responses:

The metafield namespaces that matter for AI agents

The namespace is the first part of the namespace.key pair. Several namespaces have semantic meaning to external systems:

The google namespace in detail

The google namespace metafields are the most directly impactful for AI shopping agent visibility because they provide structured category and attribute data that is not available in the default Shopify product model:

Reading metafields in Liquid for JSON-LD output

To include google.google_product_category in your Product JSON-LD (required for AI agent category matching), add this to your theme's JSON-LD Liquid snippet:

{% assign gpc = product.metafields['google']['google_product_category'].value %}
{% assign condition = product.metafields['google']['condition'].value | default: 'new' %}

{
  "@type": "Product",
  "name": {{ product.title | json }},
  {% if gpc != blank %}
  "category": {{ gpc | json }},
  {% endif %}
  "offers": {
    "@type": "Offer",
    "itemCondition": "https://schema.org/{% if condition == 'refurbished' %}RefurbishedCondition{% elsif condition == 'used' %}UsedCondition{% else %}NewCondition{% endif %}"
  }
}

Bulk-setting metafields via CSV import

For stores with large catalogs, setting google.google_product_category one product at a time in the admin is impractical. The fastest bulk path is via Shopify's product CSV import with metafield columns:

# CSV column header format for metafield import:
# Metafield: namespace.key [type]
# Example column header:
Metafield: google.google_product_category [single_line_text_field]

# One row per product, with the taxonomy ID or path in the column value:
2271
# or:
Apparel & Accessories > Clothing > Shirts & Tops

FAQ