Store Owner Tips

Subscribe to our newsletter

Weekly ecommerce tips, deals & news.

Thank You, we'll be in touch soon.

Latest News

Supplemental Feed

A supplemental feed is a second product feed that adds or overrides data in your main feed without rebuilding it. A supplemental feed carries only the product IDs you want to change, plus the fields to change. Google Merchant Center then merges it into the primary feed automatically. That speed makes supplemental feeds the usual first fix for a product disapproval.


Key Takeaways

  • A patch, not a replacement: A supplemental feed edits products that already exist in your primary feed.
  • It cannot add products: Google is explicit that supplemental feeds only update existing items, never create new ones.
  • The product ID is the join: Matching happens on the id attribute, and the match is case sensitive.
  • The stakes are large: Google’s Shopping Graph holds 35 billion product listings and counting.

How Does a Supplemental Feed Work?

A supplemental feed works by matching its rows to your primary feed on the product ID. It then applies only the fields it contains. You upload a small file, often just a spreadsheet with two columns. Merchant Center merges those values in, and everything you left out stays as it was.

What Can a Supplemental Feed Change?

A supplemental feed can add a missing attribute or overwrite one that is already there. In practice, common jobs include filling in GTINs your store never recorded. Others include rewriting titles for a handful of products that need sharper wording. Custom labels and promotion IDs are frequent additions too.

The appeal is that none of this touches your product data feed at source. For example, you can test a new title on twenty products without editing twenty WooCommerce listings. If the change flops, you delete the supplemental feed and everything reverts.

Still, data that lives outside your store is the strongest use case. Performance figures from an ads account, or GTINs researched by hand, have nowhere natural to sit in WooCommerce. A supplemental feed gives that data a home.

What Can’t a Supplemental Feed Do?

A supplemental feed cannot create products, and that limit catches people out constantly. Google states plainly that supplemental feeds only update items already present in a primary feed. A row whose ID matches nothing is simply ignored. No error appears to tell you the product never existed.

Meanwhile, partial updates also leave the product expiration date alone. A supplemental feed will not keep a stale product alive. Your primary feed still has to refresh on schedule.

Supplemental feeds are a patch layer, not a fix for a broken source. If your primary feed is missing brands catalog-wide, the durable answer is feed mapping in your feed tool. Patching thousands of rows by spreadsheet is a treadmill.

How Does the Matching Work?

Matching works on the id attribute, which must appear in every supplemental feed alongside at least one other column. Think of it as joining two guest lists by ticket number. The names and seats can differ, but the ticket number decides which rows belong together.

The critical detail is that IDs are case sensitive. An ID of SKU-100 will not match sku-100. In practice, that single mismatch is the most common reason a supplemental feed appears to do nothing at all.

For example, always copy IDs from an export of the primary feed rather than retyping them. Spreadsheet software is also happy to mangle long numeric IDs into scientific notation. Format the ID column as text before you paste anything into it.

What Do the Numbers Say About Supplemental Feeds?

Feed quality decides visibility across far more of Google than most store owners realize. That reach is what makes a fast patching tool valuable. Google states that an approved free listing can appear on 7 surfaces.

Those surfaces are Search, Maps, Images, Lens, YouTube, the Shopping tab, and Gemini. One disapproved attribute removes a product from all of them at once.

Even so, the bar for entry is genuinely low. Google’s product data specification requires only 7 attributes for every product: id, title, description, link, image link, availability, and price. Most disapprovals come from conditionally required fields instead, such as brand or GTIN.

AdTribes, which builds product feed tooling for WooCommerce stores, points store owners at supplemental feeds for exactly these gaps. Their guidance is consistent on the split. Patch the exceptions with a supplemental feed, and fix systematic gaps at the source.


What Does a Supplemental Feed Look Like in Practice?

Here’s a hypothetical example. Picture a hardware store running a catalog of roughly two thousand products. Merchant Center flags about forty of them as disapproved for a missing GTIN. Those forty are all obscure imported fittings the supplier never provided barcodes for.

The Setup

The team downloads the disapproved list from Merchant Center as a spreadsheet. Next, they research the correct barcodes from the manufacturer’s documentation. They then build a two-column file: product ID and GTIN.

Then that file goes into Merchant Center as a supplemental feed linked to the primary one. No WooCommerce products are edited. The whole job takes an afternoon rather than a development sprint.

The Results

In this scenario, the forty products clear their disapproval at the next feed refresh. The rest of the catalog is untouched, so nothing else can break. Meanwhile, the store keeps a clean record of which GTINs were added by hand.

However, the team then hits the predictable follow-up problem. New imported fittings arrive every month with the same missing barcodes. Patching each batch by spreadsheet becomes its own recurring chore.

The durable answer is to capture GTINs in WooCommerce at the point products are created. As a result, the supplemental feed shrinks back to what it is best at: genuine exceptions.


What’s the Difference Between a Supplemental Feed and a Primary Feed?

What you’re comparingPrimary feedSupplemental feed
Can create productsYes, it defines the catalogNo, it only updates existing ones
Coverage neededEvery product, every required fieldOnly the rows you want to change
Typical sourceGenerated by your feed pluginA hand-built or external spreadsheet
Effect if removedProducts stop showing entirelyProducts revert to primary values

A primary feed defines your catalog, while a supplemental feed only edits it. Every store needs a primary feed, and most stores can happily run without a supplemental one. The moment you need data that your store does not hold, though, a supplemental feed is usually the shortest route.

By contrast, both live under Data Sources in Google Merchant Center, which is why the two get confused. Only the primary feed, however, decides whether a product exists at all.


What Are the Pros and Cons of Supplemental Feeds?

The Pros

  • Fast to deploy: A spreadsheet and an upload can clear a disapproval the same day.
  • Low blast radius: Only the rows you list are affected, so the rest of the catalog is safe.
  • Easy to undo: Deleting the supplemental feed restores the original values automatically.

The Cons

  • It hides the real problem: Patching symptoms can leave a broken source feed in place for months.
  • Silent failures: A mistyped ID matches nothing, and Google reports no error for it.
  • Manual upkeep: New products need new rows, so the file drifts out of date quickly.

Frequently Asked Questions

Can a supplemental feed add new products?

No. Google restricts supplemental feeds to updating products that already exist in a primary feed. A row with an ID that matches nothing is skipped silently. To add products, you have to change the primary feed instead.

Why is my supplemental feed not working?

In most cases, the cause is an ID that does not match the primary feed exactly. IDs are case sensitive, so a difference in capitals breaks the join. Spreadsheet formatting is the other frequent culprit, especially numeric IDs converted to scientific notation. Export your primary feed and compare the two ID columns directly.

Should I use a supplemental feed or fix my main feed?

Use a supplemental feed for exceptions and fix the main feed for patterns. Forty products missing a barcode is an exception worth patching. Four thousand products missing a brand is a mapping problem in your feed tool. A good rule is to ask whether next month’s new products will have the same gap.


Why Do Supplemental Feeds Matter?

Supplemental feeds matter because a single missing attribute can pull a profitable product out of Google entirely. Patching that gap in an afternoon turns a stalled listing into a live one. Better still, your catalog is never touched. Used well alongside proper feed optimization, they are the fastest recovery tool a store has.

Share article

Subscribe to our newsletter

Weekly ecommerce tips, deals & news.

Nice – You're in!

Copyright © StoreOwnerTips.com. All Rights Reserved.