Articles on: Shopify

Google Fields using Metafields

Update Google Shopping attributes for Shopify products by mapping feed data directly into variant-level metafields under the Google Shopping namespace.


Available on: ✔️ Add | ✔️ Update


This field configuration is deprecated as of December 2024. For modern Shopify stores, Shopify Standard Product Taxonomy and native Category metafields are recommended.



How to Set Up Google Fields via Metafields


Go to App → Feed Settings → Step 2: Matching Column


  1. Add Metafield Mapping: Click Add Field and select Metafield in the field dropdown.
  2. Configure Namespace and Key: Enter the designated namespace and key (e.g., mm-google-shopping.google_product_category) in the field settings.
  3. Set Metafield Owner: Set the Metafield Owner to Variant.
  4. Map Column: Select the column from your feed file that contains the corresponding Google Shopping attribute value.


For example:

Metafield mapping example



Google Shopping Metafield Mapping Reference


The table below lists the required namespace, key, and owner settings for each Google Shopping field:


Google Fields

Metafield Namespace and Key

Metafield Owner

Google Product Category

mm-google-shopping.google_product_category

Variant

Gender

mm-google-shopping.gender

Variant

Brand

mm-google-shopping.brand

Variant

MPN

mm-google-shopping.mpn

Variant

Size

mm-google-shopping.size

Variant

Color

mm-google-shopping.color

Variant

Custom Product

mm-google-shopping.custom_product

Variant

Product Type

mm-google-shopping.product_type

Variant

GTIN

mm-google-shopping.gtin

Variant

Shipping Weight

mm-google-shopping.shipping_weight

Variant



Google Product Category Taxonomy Requirements


If you provide a Google Product Category in your feed, Shopify uses Google's taxonomy to map the category to your products accurately.


Values must match Google's official taxonomy names in English or their corresponding numerical IDs.Refer to the official Google Product Category Taxonomy to verify accepted category strings and IDs.



Key Rules & Technical Details


  • Metafield Owner Level: All Google Shopping metafields listed above must be assigned to the Variant level, not Product level.
  • Exact Syntax Matching: The namespace and key must be entered exactly as mm-google-shopping.[key] with no extra spaces or uppercase letters.
  • Taxonomy Validation: Invalid taxonomy names or IDs will fail Google Merchant Center sync validation.



Troubleshooting Steps


  • Issue: Google Shopping fields do not appear in Shopify → Solution: Verify that the Metafield Owner is set to Variant and that the namespace and key match the table above exactly.
  • Issue: Google Product Category is rejected by Google Merchant Center → Solution: Check your feed values against the official Google Taxonomy list to ensure values use exact English paths or valid numeric category IDs.



Good Articles to Continue


Updated on: 27/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!