How to Match WooCommerce Fields with Google Shopping Attributes
Mapping WooCommerce fields to Google Shopping attributes ensures your products display correctly and stay visible. Using the WooCommerce Product Feed Plugin streamlines this process by connecting fields like price, brand, GTIN, and shipping labels to their official Google counterparts before submission to Google Merchant Center. Accurately matching these values is essential for preventing feed disapprovals and errors.
This guide covers required attributes, exact configuration steps, and fixes for common mapping mistakes involving brands, GTINs, and shipping labels.
Google Shopping Attribute Requirements
Google Shopping requires specific attributes in a specific format before it will approve your feed:
- ID: A unique identifier for each product, usually the SKU.
- Title: The product name as it should appear in search results.
- Description: A factual product description.
- Price: The current selling price.
- Availability: In stock, out of stock, or preorder.
- Brand: Required for most product categories.
- GTIN: The Global Trade Item Number used to match your product to Google’s catalog.
- MPN: Manufacturer Part Number, used when no GTIN exists.
- Google Product Category: Google’s own taxonomy value for the product.
- Condition: New, used, or refurbished.
- Shipping_Label: A tag used to apply shipping rules to groups of products.
- Color, Size, Material: Required for products where these attributes affect the buying decision.
If any WooCommerce field does not map cleanly to one of these, Google will flag the product with a missing or invalid attribute error and may reject it from the feed.
How to Map WooCommerce Fields to Google Shopping Attributes Using a Plugin
Step 1: Install and Activate CTX Feed
Go to Plugins > Add New in your WordPress dashboard, search for CTX Feed, then install and activate it. Access it from the Product Feeds menu inside WooCommerce.
Step 2: Create a New Google Shopping Feed
Click Add New Feed, select Google Shopping as the channel, choose XML as the feed format, and set your target country and language.
Step 3: Map WooCommerce Attributes to Google Attributes
Open the Attribute Mapping section for your Google Shopping feed. For each required or recommended attribute, select the matching WooCommerce field from the dropdown. Common mappings:
- Title: WooCommerce Product Title.
- Description: WooCommerce Product Description.
- Price: WooCommerce Regular Price or Sale Price.
- Availability: WooCommerce Stock Status.
- Brand: WooCommerce Brand attribute or a custom field.
- GTIN: A custom field such as barcode or ISBN.
- MPN: A custom manufacturer part number field.
- Google Product Category: CTX Feed’s category mapping tool, aligned to Google’s taxonomy.
- Color, Size, Material: WooCommerce product attributes or variations.
If your store uses custom fields, such as barcode or ISBN, add them to CTX Feed’s mapping options so they appear as selectable sources.
Step 4: Apply Category-Level Mapping Rules
Set a fixed value, such as a brand name or material, for an entire category instead of editing every product. This saves time on large catalogs and keeps values consistent. You can also exclude specific categories from a rule.
Step 5: Override Attributes on Individual Products
If a specific product needs a different brand or GTIN than its category default, edit that field directly on the product page. CTX Feed applies individual product values over category-level rules.
Step 6: Save and Generate the Feed
Save your mapping settings, generate the feed, and copy the feed URL. Submit that URL to Google Merchant Center as a scheduled fetch, or download the file and upload it manually.
Step 7: Monitor and Adjust
Check Google Merchant Center regularly for feed errors or warnings. Update your attribute mappings in CTX Feed whenever Google changes a requirement or you add new product data.
How to Map the Shipping_Label Field in a WooCommerce Google Product Feed
To map the shipping_label field, create a custom field or attribute in WooCommerce that stores your shipping group name, then link it to the shipping_label attribute inside CTX Feed’s Google Shopping mapping section. Google uses shipping_label to group products under specific shipping rules, such as a “bulky” label for heavy items and a “standard” label for everything else, so Merchant Center applies the correct rate automatically.
Steps to map shipping_label in CTX Feed:
- Create a custom field or attribute in WooCommerce named shipping_label, or reuse an existing field that stores your shipping group.
- Open CTX Feed and go to your Google Shopping feed settings.
- Find the shipping_label attribute in the mapping section.
- Map it to your WooCommerce custom field, or set a static value if every product shares one shipping group.
- If different categories need different labels, use CTX Feed’s category-level rules to assign shipping_label per category.
- Save your settings and regenerate the feed.
If shipping overrides in Merchant Center are not matching your products after this setup, check that the field value in WooCommerce exactly matches the label name configured in your Merchant Center shipping settings. A mismatch in spelling or capitalization is the most common cause of shipping_label mapping failures.
How to Set Up the WooCommerce Brand Field for Google Shopping
Google requires the brand attribute for most product categories, and a missing brand field is one of the most common reasons WooCommerce feeds get flagged in Merchant Center.
To add and map it:
- Install a brand taxonomy plugin, such as Perfect Brands for WooCommerce, or create a custom WooCommerce attribute named Brand.
- Assign a brand value to each product.
- In CTX Feed, map the Google brand attribute to your WooCommerce brand field or custom attribute.
- If every product in your store shares one brand, use CTX Feed’s static value option instead of setting it per product.
- Save and regenerate the feed.
Without a brand value, your products will not appear in branded search queries, which directly reduces visibility and click-through rate.
How to Map the WooCommerce Barcode Field as GTIN
Google uses the GTIN, or Global Trade Item Number, to verify a product and match it against listings already in its database. WooCommerce does not include a GTIN field by default, so you need to add one:
- Add a custom field named barcode or GTIN to your products.
- Enter the UPC, EAN, or ISBN value for each product.
- In CTX Feed, map the Google GTIN attribute to your WooCommerce barcode field.
- For products that genuinely have no GTIN, such as handmade items, set identifier_exists to “no” in CTX Feed instead of leaving the field blank.
How to Export Your WooCommerce Product Feed to Google Shopping
Once mapping is complete, you have two ways to get the feed into Merchant Center:
- Automatic URL fetch: CTX Feed generates a feed URL that Google Merchant Center fetches on a schedule you set, hourly, daily, or weekly.
- Manual download: Download the XML or CSV file from CTX Feed and upload it directly to the Merchant Center.
Automatic fetch is the better option for stores with regularly changing prices or stock levels, since it keeps Merchant Center in sync without manual re-uploads.
Channel Category Attribute Mapping for Multi-Channel Selling
If you sell on more than one channel, each one expects a different category taxonomy and, in some cases, different required attributes. Google Shopping uses its own google_product_category values, while Facebook and TikTok use their own systems.
CTX Feed handles this by letting you create a separate feed per channel, each with its own attribute mapping rules, so the same WooCommerce product data can be mapped differently depending on where it is going. This means one product can carry a Google-specific category value in the Google feed and a Facebook-specific category value in the Facebook feed, without conflicting.
Common Google Shopping Attributes and Their WooCommerce Mapping Source
| Google Attribute | WooCommerce Field / Mapping Source | Notes |
|---|---|---|
| id | Product SKU or ID | Unique identifier for each product |
| title | Product Title | Keep concise and keyword-relevant |
| description | Product Description | Factual, not promotional |
| link | Product URL | Generated automatically |
| image_link | Featured Image | Use a high-resolution image |
| availability | Stock Status | In stock, out of stock, or preorder |
| price | Regular Price or Sale Price | Must match the live site price |
| brand | Brand attribute or custom field | Required for most categories |
| gtin | Custom field (barcode, ISBN) | Global Trade Item Number |
| mpn | Custom field (manufacturer part number) | Use when no GTIN exists |
| google_product_category | Category mapping tool | Must match Google’s taxonomy |
| condition | Product Condition | New, used, or refurbished |
| color | Product Attribute (Color) | Use exact color names |
| size | Product Attribute (Size) | Match Google’s size system |
| material | Product Attribute (Material) | Optional but recommended |
Best Practices for Attribute Mapping
- Use global WooCommerce attributes, such as Brand and Color, instead of one-off product fields, so mapping stays consistent across your catalog.
- Map custom fields for unique identifiers like ISBN or UPC directly to GTIN rather than leaving them unmapped.
- Match Google’s expected values exactly. For example, Condition must be “new,” “used,” or “refurbished,” not a custom phrase.
- Use the category mapping tool for google_product_category rather than guessing, since Google’s taxonomy is extensive and specific.
- Check Google Merchant Center’s feed diagnostics after every regeneration to catch mapping errors before they cause disapprovals.
Best WooCommerce Product Feed Plugin for Attribute Mapping: CTX Feed
CTX Feed is a WooCommerce product feed plugin with over 70,000 active installations, built to map product data to more than 220 shopping and marketplace channels, including Google Shopping, Facebook, Pinterest, and TikTok. It bridges the gap between WooCommerce’s default field structure and the specific format each channel requires.
For attribute mapping specifically, it supports both required and optional Google attributes, category-level rules that apply across an entire product category at once, and per-product overrides when individual items need different values than the rest of their category.
Key Features
- Attribute mapping interface for linking WooCommerce fields, including custom fields, to Google Shopping and other channel attributes.
- Category-level mapping rules that apply a value across an entire category, with the option to exclude specific categories.
- Custom field support for mapping identifiers such as ISBN or barcode to GTIN or MPN.
- Per-product overrides that take priority over category-level rules.
- Scheduled feed regeneration to keep Merchant Center data current automatically.
- Support for 220+ channels beyond Google Shopping, including Facebook, Pinterest, and TikTok, using the same mapping structure.
A free version is available on WordPress.org. Pro adds features such as dynamic attributes and ACF field support. Check the official pricing page before purchasing, since plans change.
Frequently Asked Questions
Why is my product feed showing a missing brand field error?
This happens when a product has no brand value assigned in WooCommerce. Add a Brand attribute or use a brand taxonomy plugin, assign a value to every product, then map that field to the Google brand attribute in CTX Feed. If every product shares one brand, use CTX Feed’s static value option instead.
Why is Google not applying my shipping_label rules?
The shipping_label value in WooCommerce usually does not exactly match the label configured in your Merchant Center shipping settings. Check spelling and capitalization on both sides, then regenerate the feed after correcting the mismatch.
What do I do if a product has no GTIN?
Set the identifier_exists attribute to “no” in CTX Feed instead of leaving the GTIN field blank. This tells Google the product genuinely has no GTIN, rather than flagging it as a missing required field.
Can I map WooCommerce product attributes to Google product categories?
Yes. Use CTX Feed’s category mapping tool to align each WooCommerce category with the closest matching value in Google’s product taxonomy, rather than mapping by name alone, since Google’s category names do not always match WooCommerce’s.
Can I review or edit my WooCommerce product attributes in Google Sheets?
CTX Feed’s mapping is configured inside WordPress, not in Google Sheets. If you want to review your product attribute data outside WordPress, export your WooCommerce products to CSV first, since CSV opens directly in Google Sheets for review or bulk editing before you re-import.
Key Takeaways
- Map every required Google Shopping attribute, including brand, GTIN, and shipping_label, before submitting your feed to avoid disapprovals.
- A missing brand value is one of the most common causes of feed errors and lost branded search visibility.
- Shipping_label mismatches between WooCommerce and Merchant Center are almost always a spelling or capitalization issue.
- Use category-level mapping rules for consistency across large catalogs, and reserve per-product overrides for genuine exceptions.
- Selling on multiple channels means mapping the same WooCommerce data differently for each one, since taxonomies and requirements are not shared across platforms.
- Check Google Merchant Center’s feed diagnostics after every regeneration rather than assuming the mapping worked.