What Is a Supplemental Feed?
A supplemental feed is a secondary product feed in Google Merchant Center that modifies or adds data to your primary feed. It cannot create new products — it can only update attributes on products that already exist in your primary feed. The supplemental feed matches products by their id attribute and applies the specified changes.
Supplemental feeds solve a common problem: you need to change certain product attributes for Google Shopping but do not want to (or cannot) modify your primary feed. Your primary feed might be auto-generated by Shopify, WooCommerce, or a feed management tool. A supplemental feed lets you override titles, add missing GTINs, set custom labels, or add sustainability attributes without touching the source.
Why It Matters for Google Merchant Center
Most merchants do not have full control over their primary feed. Shopify generates feed data from your product listings. WooCommerce plugins pull from your product database. Feed management tools process data according to rules you set. In all cases, certain attributes may be missing, incorrectly formatted, or suboptimal for Shopping performance.
Supplemental feeds give you a correction layer between your store data and what Google sees. Common use cases:
- Fixing feed errors without modifying your store data
- Optimizing titles for search performance without changing product names on your website
- Adding GTINs in bulk that are not stored in your e-commerce platform
- Setting custom labels for campaign segmentation in Google Ads
- Adding promotional attributes like sale prices with effective dates
- Correcting category mappings when auto-categorization is inaccurate
This flexibility makes supplemental feeds essential for merchants who want to optimize their Shopping performance beyond what their e-commerce platform provides natively.
How Supplemental Feeds Work
Setup
- In Merchant Center, go to Products > Feeds > Supplemental feeds
- Click Add supplemental feed
- Choose a name and input method (Google Sheets, scheduled fetch, or upload)
- Define which primary feed the supplemental feed modifies
- Upload your supplemental data with
idas the matching key
Data Format
A supplemental feed only needs two types of columns:
id— Must match theidin your primary feed exactly- Attributes to update — Only include the columns you want to change
For example, to optimize titles for 3 products, your supplemental feed would look like:
| id | title |
|---|---|
| SKU-001 | Nike Air Max 90 White Men's Running Shoes Size 10 |
| SKU-002 | Samsung Galaxy S24 Ultra 256GB Titanium Gray Unlocked |
| SKU-003 | KitchenAid Stand Mixer 5-Quart Artisan Series Empire Red |
Every other attribute (price, description, images, etc.) comes from the primary feed unchanged.
Processing Order
When Google processes your feeds, it:
- Loads your primary feed
- Applies supplemental feed data on top, overriding matching attributes
- Validates the combined data against the product data specification
If an attribute exists in both the primary and supplemental feed for the same product, the supplemental feed value wins.
Google Sheets as a Supplemental Feed
The simplest method for small-to-medium catalogs is a Google Sheets supplemental feed:
- Create a Google Sheet with
idin column A and your attributes in subsequent columns - In Merchant Center, add a supplemental feed and select "Google Sheets" as the source
- Grant Merchant Center access to the sheet
- Merchant Center checks the sheet on a schedule you define
This approach lets you make quick changes to product data by editing a spreadsheet — no technical expertise required.
Common Issues and Fixes
-
Supplemental feed not applying — The
idvalues must match your primary feed exactly, including case sensitivity and formatting. If your primary feed uses "SKU-001" and your supplemental feed uses "sku-001," the match fails silently. -
Overridden data reverting — If your primary feed processes after your supplemental feed, the primary data temporarily overwrites supplemental data until the supplemental feed is re-processed. Set supplemental feed processing to run after primary feed processing.
-
Cannot add new products — Supplemental feeds can only modify existing products. Products not in your primary feed are ignored. To add new products, you need to add them to your primary feed or use the Content API.
-
Too many supplemental feeds — Merchant Center limits you to a certain number of supplemental feeds per primary feed. If you hit the limit, consolidate multiple supplemental feeds into one.
-
Feed processing errors on supplemental data — Even though supplemental feeds are secondary, the data must still comply with the product data specification. Invalid values in a supplemental feed cause the same errors as in a primary feed.
Related Terms
- Product Feed — The primary data source that supplemental feeds modify
- Content API — An alternative method for programmatically updating product data
- Product Data Specification — The formatting rules that apply to supplemental feed data
Scan your store now to identify feed issues a supplemental feed could fix — from missing GTINs to suboptimal titles.