Google Shopping Supplemental Feeds: How to Use Them

Google Shopping supplemental feeds are one of the most powerful and least used tools in advanced Merchant Center feed management. Known formally as supplemental feeds in Google Merchant Center, they allow adding or overwriting specific attributes of products already in the primary feed without modifying the original data source, a significant advantage in any context where the primary feed is generated by an external platform or management system that cannot be edited directly.

The logic of the supplemental feed Merchant Center is simple: Google merges the data from the primary feed with that of the supplemental feed, using the product's id as the linking key. If an attribute is present in both feeds, the supplemental feed Merchant Center value overwrites the primary one. If an attribute is only in the primary feed, the primary value is used. If an attribute is only in the supplemental feed, it is added to the product. The supplemental feed cannot, however, create new products or delete existing ones, it operates exclusively on items already in the primary feed.

This article analyses when to use Google Shopping supplemental feeds, how to structure them correctly, and the errors that produce unexpected behaviour, systematically distinguishing between what Google's official documentation describes and what emerges from hands-on experience on real accounts.

How Google Shopping Supplemental Feeds Work

According to the official Google documentation on supplemental data sources (support.google.com/merchants/answer/14990942), a supplemental feed Merchant Center is an additional file containing extra or replacement attributes for products already in the primary feed. The link is made via the id attribute: every row of the supplemental feed Merchant Center must contain the id of the product it refers to, and that id must exactly match an id in the primary feed.

The attribute overwrite logic

When Google processes Google Shopping supplemental feeds, it applies an attribute merge logic per product:

• If the attribute is present in the supplemental feed Merchant Center, the supplemental value overwrites the primary feed value.
• If the attribute is only in the primary feed, the primary value is used.
• If the attribute is only in the supplemental feed Merchant Center, it is added to the product as an additional attribute.

Independent update frequency

Google Shopping supplemental feeds can have a completely independent update frequency from the primary feed. A supplemental feed Merchant Center can be updated every hour while the primary feed updates every 24 hours, or vice versa. This is one of the main reasons to use them: it allows updating attributes that change frequently (such as custom labels based on availability or daily margin) without reprocessing the entire primary feed.

When to Use Google Shopping Supplemental Feeds

Google Shopping supplemental feeds are not always the best solution. There are cases where their use is clearly indicated, and cases where directly modifying the primary feed is preferable.

Cases where Google Shopping supplemental feeds are the right choice

• Primary feed not editable: when the feed is generated automatically by an e-commerce platform (Shopify, WooCommerce, Magento) or an external supplier, and it is not possible to intervene on the data source. The supplemental feed Merchant Center allows enriching the feed without depending on the platform.
• Updates at different frequencies: when some attributes change far more frequently than others, for example custom labels based on daily margin or availability, on a primary feed that updates weekly. Google Shopping supplemental feeds allow updating only those attributes at the required frequency.
• Title optimisation testing: when you want to test search-optimised titles without modifying the originals in the CMS. A supplemental feed Merchant Center with rewritten titles overwrites the primary feed titles only in Google Shopping, leaving the website unchanged.
• Adding strategic custom labels: when you want to assign custom labels for campaign segmentation, e.g. custom_label_0 = high_margin, without that information being in the management system. Google Shopping supplemental feeds are the natural place for these enrichments.

Cases where modifying the primary feed is preferable

Google Shopping supplemental feeds introduce operational complexity: they are a second file to maintain, update, and monitor. If the primary feed is accessible and editable, adding attributes directly to the primary feed is almost always simpler and less prone to desynchronisation errors. The supplemental feed Merchant Center is a tool for cases where there is no alternative, not a universal best practice.

How to Structure a Supplemental Feed Merchant Center

The structure of the supplemental feed Merchant Center is simpler than the primary feed: it does not require all mandatory attributes, only the product's id and the attributes to add or overwrite. This makes it easy to create, but easy to get wrong.

The id column: the critical link

The only truly mandatory attribute in Google Shopping supplemental feeds is the id. It must exactly match the id of the product in the primary feed, same value, same capitalisation, no additional spaces. An id mismatch produces silent behaviour: the supplemental feed Merchant Center generates no visible error, it simply does not apply to the product.

Include only the necessary attributes

A well-structured supplemental feed Merchant Center contains only the id and the attributes that actually need to be overwritten, not a copy of the primary feed with a few fields changed. Including unnecessary attributes in the supplemental feed Merchant Center increases the risk of an incorrect value overwriting a correct primary feed value. The operational rule is: fewer attributes in the supplemental feed, fewer risks of unexpected behaviour.

Format and update method

Google Shopping supplemental feeds support the same formats as the primary feed: Google Sheets, XML, CSV and TSV files, and updates via URL fetch or SFTP. Google Sheets is the most practical choice for supplemental feed Merchant Center files used for custom labels or title optimisation: it allows editing values directly from the web interface without uploading a file, and updates automatically with each Google fetch.

Frequent Errors and Limits of Google Shopping Supplemental Feeds

1. Overwriting mandatory attributes with empty values

If the supplemental feed Merchant Center includes the column for a mandatory attribute but with an empty value for some products, that empty value overwrites the correct value in the primary feed, producing a disapproval for missing attribute. In Google Shopping supplemental feeds it is essential never to include empty columns for mandatory attributes: it is preferable to omit the column entirely from the supplemental feed if you do not have a value to provide for all products.

2. Desynchronisation between primary and supplemental feed

This is the most frequent structural error in managing Google Shopping supplemental feeds. Every time the primary feed changes structure (new products, renamed IDs, removed products), the supplemental feed Merchant Center must be updated accordingly. If it is not updated, it silently stops applying to modified products and continues applying to unchanged ones, potentially overwriting attributes on products that should not be touched.

3. Limitations on overwritable attributes

Not all feed attributes can be overwritten via Google Shopping supplemental feeds. Official documentation indicates that some critical attributes, such as price and availability, cannot be reliably modified via the supplemental feed Merchant Center for landing page coherence reasons. Attempting to overwrite them produces undocumented behaviour: in some cases the supplemental value is ignored, in others it produces an error that does not appear in the Diagnostics section but is visible in the feed processing log.

FAQ: Google Shopping Supplemental Feeds