Merchant Center

Google Product Feed: Required Attributes and Setup

For online store owners who sell through Google: which attributes your feed must include, which ones depend on your products, how to send the data, and how to clear the errors that keep products offline.

Safeer SafeerGoogle Ads & Merchant Center strategist Updated 15 min read
Diagram of a Google product feed moving from a store catalog through a Merchant Center data source to Shopping ads and free listings

Quick answer

A Google product feed is the product data you send to Google Merchant Center, one item per product, by file, app or API. As of November 2026, every product needs id, title, description, link, image_link, availability and price. Brand, GTIN, MPN, condition, color, size and shipping depend on the product and the country.

Key takeaways

  • A Google product feed is the product data you send to Merchant Center, and Google now calls it a data source, whether it arrives as a file, a spreadsheet, an app sync or an API call.
  • Seven attributes are required for every product (id, title, description, link, image_link, availability and price), and brand is also required for new products other than movies, books and music.
  • A US apparel store must also send color, gender and age_group, plus size for clothing and shoes, and item_group_id on every variant.
  • As of November 2026, google_product_category is optional, because Google assigns a category to every product automatically and accepts an override only in specific cases.
  • Products expire from Merchant Center 30 days after their last refresh, so a feed needs a scheduled sync rather than a single upload.
On this page
  1. What is a Google product feed?
  2. Which attributes does Google require in a product feed?
  3. Which feed attributes depend on the product or country?
  4. Which optional attributes are worth adding?
  5. What does a sample product feed row look like?
  6. Should you use a file, the API or a platform sync?
  7. How do you set up a Google product feed?
  8. What is a supplemental feed and when do you need one?
  9. What are the most common product feed errors?
  10. How often should you update a Google product feed?
  11. What changed in the product data specification in 2026?
  12. FAQ

What is a Google product feed?

A Google product feed is a structured list of the products you sell, sent to Google Merchant Center so they can appear in Shopping ads, free listings and other Google surfaces. Each item is one product, and each fact about it (title, price, image, stock status) is an attribute. Google's product data specification says it uses this data to match products to searches, and a Shopping campaign has no keywords of its own to do that job.

A feed doesn't have to be a file. It can be a spreadsheet, an app connection or an API. Google renamed feeds to data sources when Merchant Center Next rolled out, and Diagnostics became the Needs attention tab. Most people still say product feed or Google Shopping feed, so we use feed here and data source when we point at a Merchant Center screen.

Your catalogStore platform, file, sheet or database
Data sourceThe feed: one item per product or variant
Merchant CenterChecks the data and the landing page
Google surfacesShopping ads and free listings
A feed carries product data from your catalog into Merchant Center, where Google reviews it before products can show.

Which attributes does Google require in a product feed?

Seven attributes are required for every product: id, title, description, link, image_link, availability and price. Google's specification says that without a required attribute, a product won't be able to serve in ads and free listings. The table shows the rules as of November 2026.

AttributeGoogle's ruleExample
idUnique, max 50 characters. Use the SKU where possible and keep it the same when you update.MRW-CN-NVY-M
titleMax 150 characters. Matches the landing page, with no promotional text or all capitals. AI-written titles go in structured_title.Mens Pique Polo Shirt
descriptionMax 5,000 characters. Only about the product, with no store links or sale text. AI-written text goes in structured_description.Made from 100% organic cotton
linkYour verified domain, starting with http or https, as an encoded URL.https://www.example.com/polo
image_linkMain image as JPEG, WebP, PNG, non-animated GIF, BMP or TIFF. No promotional text, watermarks, borders or placeholders.https://www.example.com/polo.jpg
availabilityOne of in_stock, out_of_stock, preorder or backorder. Matches the landing page and checkout.in_stock
priceNumber plus currency code. Matches the page, structured data and checkout. US prices leave out sales tax. No price of 0, apart from contract and subscription exceptions.15.00 USD

Titles do the most work after approval, so our guide to Google Shopping product titles covers them by category.

Watch for old lists. Some guides still list condition as required for every product. As of November 2026, Google's specification requires it only for used and refurbished products, and it marks google_product_category as optional.

150Characters in a title
5,000Characters in a description
4 GBLargest product file
30 daysUntil a product with no refresh expires
500 x 500Minimum image pixels from January 31, 2027
The limits people hit most often, from Google's specification and help pages as of November 2026.

Which feed attributes depend on the product or country?

Conditional attributes apply when the product, its category or the target country triggers them. Google labels these "It depends" or lists the condition beside the attribute. For a US store, the usual triggers are identifiers, shipping, apparel, variants, used goods and preorders.

AttributeWhen a US store needs itWhat to know
brandAll new products except movies, books and musical recordingsMax 70 characters. Never "N/A" or "Generic". Leave it empty if the product truly has no brand.
gtinGoogle says it depends, and strongly recommends it if availableA product with a GTIN sent without one may get limited visibility. A wrong GTIN gets it disapproved.
mpnOnly if the product has no manufacturer-assigned GTINDon't guess. An incorrect MPN also gets the product disapproved.
identifier_existsOptional, and the default is yesSet it to no only when the product really lacks identifiers. A false no can get it disapproved.
shippingShipping costs are required for US listingsUse this attribute when your account settings don't cover the product or you need an override.
conditionUsed and refurbished productsValues are new, refurbished or used, in English.
availability_datePreorder, and Google's availability rules ask for it on backorder tooUp to one year ahead, shown on the landing page.
colorAll apparel, plus anything sold in different colorsNever "multicolor" or a number. Separate several colors with a slash.
sizeClothing and shoes, plus anything sold in different sizesDon't put a multipack count in this field.
gender, age_groupAll apparel, plus gender-specific products and products with assigned age groupsGender is male, female or unisex. Age group is newborn, infant, toddler, kids or adult.
item_group_idEvery product that is a variantUse the parent SKU. It groups variants so they show together.
material, patternWhen they tell variants in a set apartSeparate up to three materials with a slash.
is_bundle, multipackBundles and multipacks you created yourselfDon't use multipack on a pack the manufacturer assembled.
promotion_idProducts linked to US promotionsMax 50 characters, with up to 10 IDs per product.
shipping_weightCarrier-calculated shipping ratesDimensions are required for those rates too.

For example, an illustrative sweater sold in 4 colors and 5 sizes is 20 items in your feed. Each one gets its own id, color and size, and all 20 share one item_group_id. Our guide to what a GTIN is and where to find one covers the identifier fields for private label, custom and vintage products. Shipping costs and delivery times usually live in your account, as our Merchant Center shipping settings guide explains.

Which optional attributes are worth adding?

Start with the optional attributes that change how campaigns run or what people see on the listing. Google says optional attributes are there to help performance, so add the ones you will really use and can keep accurate.

AttributeWhat it doesLimit or rule
additional_image_linkAdds images beyond the main one, including staged and in-use shotsUp to 10
sale_price, sale_price_effective_dateShows a sale against the regular priceWith no date range, the sale price always applies
product_typeYour own category path, used for bidding and reporting in Shopping campaignsMax 750 characters. Only the first value is used.
google_product_categoryOverrides the category Google assignedUse one category. Google prefers the numeric ID.
custom_label_0 to custom_label_4Your own groups, such as margin tier or clearance, for bidding and reportingMax 100 characters and 1,000 unique values per label
product_highlight, product_detailShort selling points and technical specifications2 to 100 highlights, up to 100 details
video_linkAdds a product video to free listings and ad creationWon't affect approval status
cost_of_goods_soldAdds gross margin insights in Merchant CenterNumber plus currency code
pauseStops a product for a short time without changing stock status14 days at most, then it is disapproved

Category choice has its own rules, so read our guide to the Google product category attribute before you add it. Google assigns a category to every product and accepts an override only in certain cases.

Google also added a group it calls conversational attributes: question_and_answer, document_link, related_product, item_group_title, variant_option and popularity_rank. They help AI systems understand a product across surfaces such as AI Mode in Search, and they won't affect approval. Google recommends sending them in a supplemental data source.

What does a sample product feed row look like?

A sample feed row holds one value for each attribute, under column headers that use Google's exact attribute names. Here is one illustrative row for a US apparel store. The store and product are made up, and the GTIN is the sample number Google uses in its specification.

Column headerValueWhy it is there
idMRW-CN-NVY-MRequired. Variant SKU.
item_group_idMRW-CNRequired for variants. Parent SKU.
titleMarlow Women's Merino Wool Crew Neck Sweater, Navy, MediumRequired. Names the variant.
descriptionMerino wool crew neck sweater with ribbed cuffs and hem.Required.
linkhttps://www.example.com/products/merino-crew-neckRequired.
image_linkhttps://www.example.com/images/merino-crew-navy.jpgRequired.
availabilityin_stockRequired.
price89.00 USDRequired. No sales tax.
brandMarlowRequired for this new product.
gtin3234567890126Send it when the product has one.
colorNavyUS apparel.
sizeMUS clothing.
genderfemaleUS apparel.
age_groupadultUS apparel.
product_typeWomen > Sweaters > Crew NecksOptional. Campaign grouping.
custom_label_0bestsellerOptional. Campaign grouping.

We left out two fields on purpose. Shipping is set at account level here, so no shipping column is needed. And google_product_category stays blank, because Google assigns a category on its own.

In a tab-delimited file, the first row holds these headers and each product takes one row below, as Google's product file guide shows. You can leave a cell empty when a value doesn't apply. In XML, each attribute becomes an element with a g: prefix, such as <g:price>89.00 USD</g:price>, inside an item, and the file declares xmlns:g="http://base.google.com/ns/1.0". That same guide's XML sample writes "in stock" with a space, while the specification lists in_stock. Follow the specification.

Should you use a file, the API or a platform sync?

Use your store platform's Google connection if it has one, a hosted file if it doesn't, and the Merchant API if prices or stock change many times a day. Google's upload guide lists each route, and you can combine them.

RouteHow updates arriveBest forWatch for
Platform connectionAutomatic. Changes may take 24 to 48 hours.Stores on Shopify and similar platformsUp to 3 days for all products to appear. Make edits in the platform.
Hosted file (URL, SFTP or Google Cloud Storage)Google fetches a URL every 24 hours. With SFTP or Cloud Storage, you upload new files.Custom stores and exports from other systemsFormatting is on you. The file name must match exactly.
File upload from your computerOnly when you submit it againA first testNo automatic sync, so products can expire
Google SheetsSyncs every 24 hours by defaultSmall catalogsMust follow Google's template
Merchant APIAs often as you send updatesLarge catalogs and frequent changesNeeds a developer. A success response doesn't mean approved.
Website crawlGoogle reads schema.org markup on your storeSimple stores with clean markupDoesn't work for local inventory ads or free local listings
Product editorYou type each product in Merchant CenterA few extra productsOnly for accounts that already have products

On Shopify, the Google & YouTube app syncs the products available to your online store. You may still need to add identifiers, such as a GTIN, or brand plus MPN. If you need more control over titles or rules, our comparison of the best Google Shopping feed apps for Shopify sets the options side by side.

Content API status. Google sunset the Content API for Shopping on August 18, 2026. Since September 1, 2026, requests without an active extension fail intermittently, and Google plans a full shutdown in early 2027. Some setup guides still recommend it, so check any old plugin or script and move it to the Merchant API.

How do you set up a Google product feed?

Set up a feed by getting the account ready, building your product data, creating a primary data source in Merchant Center, and then clearing the issues Google reports. Google recommends one primary source for all your products.

  1. Prepare the account. Verify your website and add shipping and return policies. Our Google Merchant Center setup guide covers this part.
  2. Pick your route. Use the table above. Connect your platform if you have one, and skip step 3.
  3. Build the data. Export your catalog, rename columns to Google's attribute names and fill the required and conditional fields. Save as .tsv, .txt or .xml in UTF-8 or UTF-16.
  4. Create the primary data source. In Merchant Center, go to Settings › Data sources and select Add product source. Choose a file, a Google Sheets template or the API, then enter your target countries, language and marketing methods.
  5. Read the first result. Open the source and check the Latest update tab, where the "What needs attention" column lists file problems.
  6. Fix product issues. Open Products › Needs attention, work through the summary cards first, and change values where the data comes from.

Google's big events guide says a feed can take up to 72 hours to be crawled after you submit it for an initial review. Don't start the night before a launch.

What is a supplemental feed and when do you need one?

A supplemental feed is a second data source that adds to or overrides attributes in your primary source, matched by id. Use one when you can't or don't want to change the primary data, such as adding custom labels without editing your store.

Primary data source

  • The main record of your products
  • The only source type that can add or remove products
  • Sets language and country targeting
  • Works without any add-on

Supplemental data source

  • Adds or updates attributes on existing products
  • Can't add or remove products or stand alone
  • Matches on an identical id
  • Needs the Advanced data source management add-on
A primary source decides which products exist. A supplemental source only changes what is known about them.

Turn on the add-on under Settings › Add-ons, then add the source from the Supplemental sources tab, as Google's data source guide explains. The data source label must match the primary source exactly. If your feed comes from an app, check that its data source appears when you pick a primary source to attach to, because Google's page doesn't say either way.

For example, a store with 600 products wants to label 120 clearance items (illustrative numbers). It adds a Google Sheet with two columns, id and custom_label_0, and 120 rows. The other 480 products stay as they are, and a Shopping campaign can now bid on the clearance group separately.

The same add-on enables attribute rules, the new name for feed rules. Rules change values with logic instead of a sheet, such as setting a brand across a category. Google has also deprecated online inventory data sources, so fast price and stock updates can go through a supplemental source with the Take latest rule instead.

What are the most common product feed errors?

The most common feed errors are data that doesn't match the landing page, invalid values, missing variant attributes and file format mistakes. Product issues appear in the Needs attention tab, and file issues appear in the data source's Latest update tab.

ProblemUsual causeFix
Price or availability mismatchThe feed and landing page differ, often during a saleFix the source, keep Automations on and add structured data
Landing page can't be checkedPage down, or Googlebot or Googlebot-Image blocked in robots.txtRestore the page and allow the crawlers
Invalid valueFree text in a fixed field, such as "brand new" for condition or "various" for colorUse Google's supported values, in English
Missing variant dataNo item_group_id, color or size on variantsAdd them on every variant row
Incorrect GTIN or MPNGuessed values, or a code from another productUse the manufacturer's value, or leave it out if unsure
Image problemsThumbnails, watermarks, or the warning Image too small for upcoming enforcementSend a larger, clean image
File won't processUnsupported type, missing tabs, unclosed XML tags or wrong encodingRe-export as .tsv, .txt or .xml in UTF-8 or UTF-16
Product lost its historyThe id changed, so Google treats it as a new productKeep ids stable. Approval can take up to 3 business days.
Edits keep revertingA second source updated the product lastEdit one source, usually your platform

For the full list of disapproval reasons and fixes, see our guide to fixing disapproved products in Merchant Center.

How often should you update a Google product feed?

Update your feed at least once a day, and any time price or stock changes. Google says all products expire 30 days after the last refresh. Products added directly in Merchant Center don't expire, and Google can refresh a product by crawling your site. A hosted file or Google Sheet gets a daily sync, which covers most stores.

Automations, which are on by default, use your landing page to correct price, sale price, availability and condition. Google says they don't replace regular updates. They may not work for products that change more than once a day, and a product can be disapproved instead of updated.

Timing matters most before big sales. Google suggests sending new product data 3 to 5 business days before an event, but no earlier than 30 days ahead. For Black Friday on November 27, 2026, that means new products by November 20. An item switched to in_stock can take up to 24 hours to show, and Google warns against setting a product to out_of_stock to pause it. Use the pause attribute for that.

What changed in the product data specification in 2026?

Google updates the specification every year, and the biggest open change is the 500 x 500 pixel image minimum. These are the dated changes that affect a feed, from Google's 2026 specification update and announcements log.

DateChangeWhat to do
April 14, 2026New handling_cutoff_time and minimum_order_value attributesUse them only if a product differs from your account settings
April 14, 2026Warnings began for images under 500 x 500 pixelsCheck Needs attention, then View history
June 30, 2026video_link videos became eligible to serveAdd product videos if you have them
August 18, 2026Content API for Shopping sunsetMove integrations to the Merchant API
October 2026warranty attribute added for products targeting Canada, tied to Quebec's Bill 29Send it if you sell covered products to Quebec
January 31, 2027500 x 500 pixel minimum enforced on image_link and additional_image_linkReplace small images now

Google says it will optimize some smaller images so they meet the rule, and marks them with a warning. You can replace any of them by sending a larger image, and Google recommends around 1500 x 1500 pixels or above. These dates are as of November 2026, so check the specification before you plan around them.

Feed setup and cleanup is part of our Merchant Center management at Logical Gecko, an independent agency not affiliated with Google. If products sit in Needs attention and you can't trace why, we fix values at the source so they survive the next sync.

Frequently asked questions

Is a product feed the same as a Google Shopping feed?

Yes. Product feed, Google Shopping feed, data feed and Merchant Center feed all describe the same product data. Google's own term is now data source. Shopping ads and free listings read from that one source, so you don't build a separate file for each. You only choose which Google features can use it, through the marketing methods setting on the data source.

What file format does a Google product feed use?

Google accepts tab-delimited .txt and .tsv files and .xml files, such as RSS 2.0 or Atom 1.0, up to 4 GB per file. Save them as UTF-8 or UTF-16. File types such as .html and .pdf fail, and a spreadsheet saved as .xlsx needs exporting first. Google Sheets is a separate option that uses Google's own template, so you don't need to export anything.

Is there a free Google product feed template?

Yes. In Merchant Center, go to Products, select Add products, choose Use Google Sheets and select Use template. Google opens a spreadsheet with the right columns and syncs it every 24 hours by default. If you would rather build a file, Google's product file page shows sample rows, and its tab-delimited guide links to an example .txt file you can copy.

Do I need a product feed if I use Shopify?

You need product data in Merchant Center, but you don't need to build a file. The Google & YouTube app on Shopify syncs the products available in your online store, and Google recommends managing that data in your platform. Changes may take 24 to 48 hours to appear. A separate file or feed app makes sense only when you need control the app doesn't give you.

Is google_product_category required in a product feed?

No. Google's specification marks it optional, and every product gets a category automatically. Google accepts an override when a wrong category adds requirements that don't apply, when your campaigns are built on Google product categories, or when alcohol needs the correct category. Gift cards, mobile devices sold with a contract and physical goods subscriptions must also use specific categories.

How long does a new product feed take to go live?

Google says a feed can take up to 72 hours to be crawled after you submit it for an initial review, and it suggests sending new product data 3 to 5 business days before a launch or sale. A platform connection may take up to 3 days to bring in all products. Plan for the full window, and start well before a sale.

Can I have more than one feed in Merchant Center?

Yes, but Google recommends one primary data source for all your products, with excluded_destination for anything you want to keep out of a channel. Add supplemental sources for extra attributes. If the same product arrives through two sources, Merchant Center treats it as part of whichever source updated it last, so two sources can overwrite each other.

What size should product images be in a feed?

At least 500 x 500 pixels. Google begins enforcing that minimum on January 31, 2027, for image_link and additional_image_link across all product categories, and it recommends around 1500 x 1500 pixels or above. No image can exceed 64 megapixels or 16 MB. Merchant Center already shows the warning Image too small for upcoming enforcement; Google's pages date it April 14 and July 2026.

Sources27 references
  1. Google Merchant Center Help: Product data specification
  2. Google Merchant Center Help: Merchant Center product data specification update 2026
  3. Google Merchant Center Help: Merchant Center announcements change log
  4. Google Merchant Center Help: Merchant Center Help Center now fully supports Merchant Center Next
  5. Google Merchant Center Help: How to upload your products to Merchant Center
  6. Google Merchant Center Help: Create a product file for Merchant Center
  7. Google Merchant Center Help: Add products from a file to Merchant Center
  8. Google Merchant Center Help: Create a tab-delimited product data source
  9. Google Merchant Center Help: Add products to Merchant Center using Google Sheets
  10. Google Merchant Center Help: Add products from an ecommerce platform to Merchant Center
  11. Google Merchant Center Help: Syncing your products (Google & YouTube app on Shopify)
  12. Google Merchant Center Help: Create a product data source
  13. Google Merchant Center Help: Manage your data sources
  14. Google Merchant Center Help: Set up your attribute rules
  15. Google Merchant Center Help: How to use conversational attributes
  16. Google Merchant Center Help: Google product category [google_product_category]
  17. Google Merchant Center Help: Item group ID [item_group_id]
  18. Google Merchant Center Help: Shipping [shipping]
  19. Google Merchant Center Help: Image link [image_link]
  20. Google Merchant Center Help: Video link [video_link]
  21. Google Merchant Center Help: Expiration date [expiration_date]
  22. Google Merchant Center Help: Allow Merchant Center to update product information automatically
  23. Google Merchant Center Help: Tips to help your products stay approved
  24. Google Merchant Center Help: How to prepare for big events and product launches
  25. Google Merchant Center Help: The Needs attention tab
  26. Google for Developers: Merchant API, Manage your products
  27. Google for Developers: Content API for Shopping, Deprecation and sunset
Safeer

Written by

SafeerGoogle Ads & Merchant Center strategist

Safeer leads strategy at Logical Gecko, a Google Partner and Shopify Partner agency that runs Google Ads for eCommerce and home-service brands and recovers suspended Merchant Center accounts. Everything in these guides comes from work on live client accounts. More about the team.

Merchant Center recovery

Suspended right now? Get it fixed by specialists

We diagnose the exact trust issues behind your suspension, fix them with you, and handle the review request so you don't waste attempts.

How we fix misrepresentation

Keep reading

Book your Google Ads strategy call

Fill in your details and we'll schedule a call to discuss your Google Ads growth.