Field |
Description |
Information |
id |
A unique identifier for the item |
ID must be unique for each item in your catalog. If you have multiple feeds, IDs of items across different feeds still need to be unique. |
title |
Title of the item |
Use relevant titles that match with what users are searching for with key information first in the title. |
description |
Item description |
No HTML and no promotional text. Do not enclose in quotes. The description from the landing page of your offer must be the same description as indicated in the feed. |
link |
Direct URL of the item’s page on your website |
Link should point to the specific product instead of your store’s home page or pages with multiple products. |
price |
Base price, excluding tax and shipping, submitted in local currency |
Use two decimal places and no symbols (e.g. $). The price from the landing page of your offer must be the same price as indicated in the feed. |
sale_price |
(Optional)
Your product’s sale price
|
Meet the requirements for the priceattribute
Submit the sale_price in addition to the price attribute with the non-sale price
Accurately submit the product’s sale price, and match the sale price from your landing page
|
image_link |
URL of an image of the item |
Image must be: bmp, gif, exif, jpg, png, tiff. Minimum size: 500px by 500px. Cannot exceed 3.9 MB. Do not include any text within your images, including promotional messaging. |
availability |
Your product’s availability |
Supported values
- in stock
- out of stock
- preorder
|
google_product_category |
Required (for Apparel & Accessories (166), Media(783), and Software (2092) categories)
Optional for all other products
Google-defined product category for your product
Example
Apparel & Accessories > Clothing > Outerwear > Coats & Jackets
|
- Include only 1 category
- Include the most relevant category
- Include either the full path of the category or the numerical category ID
- Include a specific category for certain products:
- Alcoholic beverages must be submitted with one of these categories:
- Food, Beverages & Tobacco > Beverages > Alcoholic Beverages(499676), or any of its subcategories
- Arts & Entertainment > Hobbies & Creative Arts > Homebrewing & Winemaking Supplies (3577), or any of its subcategories
- Mobile devices sold with contract must be submitted as Electronics > Communications > Telephony > Mobile Phones (267) for phones or Electronics > Computers > Tablet Computers (4745) for tablets
- Gift Cards must be submitted as Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates (53)
|
product_type |
Optional but recommended
Product category that you define for your product
Example
Home > Women > Dresses > Maxi Dresses
|
- Include the full category. For example, include Home > Women > Dresses > Maxi Dresses instead of just Dresses
- Only the first product_type value will be used to organize bidding and reporting in Google Ads Shopping campaigns
|
IMPORTANT: 2 of 3 are required from brand/GTIN/MPN in all feeds.
|
brand |
The brand name of the product |
- Provide the brand name of the product generally recognized by consumers
- Only provide your store name as the brand in case you manufacture the product, or your product falls into a generic brand category. For example, you could submit your store name as the brand if you sell white label products or customized jewelry
- If you don’t have a brand to provide, don’t provide a value. For example, don’t use N/A, Generic, No brand, or Does not exist
- For compatible products:
- Submit the GTIN and brand from the manufacturer who actually built the compatible product
- Don’t provide the Original Equipment Manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand’s product
|
gtin |
Required for all new products with a gtin assigned by the manufacturer
Optional for all other products
Your product’s Global Trade Item Number (GTIN)
|
- Exclude dashes and spaces
- Submit only valid GTINs as defined in the official GS1 validation guide, which includes these requirements:
- The checksum digit is present and correct
- The GTIN is not restricted (GS1 prefix ranges 02, 04, 2)
- The GTIN is not a coupon (GS1 prefix ranges 98 – 99)
- For compatible products:
- Submit the GTIN and brand from the manufacturer who actually built the compatible product
- Don’t provide the Original Equipment Manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand’s product
- For multipacks:
- Use the product identifiers that relates to the multipack
- For bundles:
- Use the product identifiers for the main product in the bundle
- If you offer customization, engraving, or other personalization of a product that’s been assigned a GTIN by the manufacturer:
- Submit the GTIN and use the is_bundle attribute to let us know that the product includes customization
- If your product doesn’t have both a GTIN and MPN:
- Set identifier_exists to no (FALSE)
|
MPN |
Required only if your new product does not have a manufacturer assigned gtin
Optional for all other products
|
- Only submit MPNs assigned by a manufacturer
- Use the most specific MPN possible. For example, different colors of a product should have different MPNs
- If your product doesn’t have both a GTIN and MPN:
- Set identifier_exists to no (FALSE)
|
condition |
Required if your product is used or refurbished
Optional for new products
The condition of your product at time of sale
Supported values
- new
- Brand new, original, unopened packaging
- refurbished
- Professionally restored to working order, comes with a warranty, may or may not have the original packaging
- used
- Previously used, original packaging opened or missing
|
|
age_group |
Required for all apparel items that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products with assigned age groups
Optional for all other products and countries of sale
The demographic for which your product is intended
Supported values
- newborn
- Up to 3 months old
- infant
- Between 3-12 months old
- toddler
- Between 1-5 years old
- kids
- Between 5-13 years old
- adult
- Typically teens or older
|
|
color |
Required for all apparel items in feeds that target Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different colors
Optional for all other products and countries of sale
Your product’s color(s)
|
- Don’t use a number such as 0 2 4 6 8
- Don’t use characters that aren’t alphanumeric such as #fff000
- Don’t use only 1 letter such as R (For Chinese, Japanese, or Korean languages, you can include a single character such as 红)
- Don’t reference the product or image such as “see image”
- Don’t combine several color names into 1 word, such as RedPinkBlue. Instead, separate them with a /, such as Red/Pink/Blue. Don’t use a value that isn’t a color, such as multicolor, various, variety, men’s, women’s, or N/A.
- If your product features multiple colors, list the primary color first.
- For variants
- Include with the same value for item_group_id and different values for color
|
gender |
Required for all apparel items in feeds that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all gender-specific products
Optional for all other products and countries of sale
The gender for which your product is intended
Supported values
|
- For some Apparel & Accessories (166) categories like Shoelaces (1856), this attribute is recommended instead of required since these categories aren’t dependent on gender
- For variants
- Include with the same value for item_group_id and different values for gender
|
material |
Required if relevant for distinguishing different products in a set of variants
Optional for all other products
Your product’s fabric or material
|
- To indicate multiple materials for a single product (not variants), add a primary material, followed by up to 2 secondary materials, separated by a /. For example, instead of CottonPolyesterElastane, use cotton/polyester/elastane
- For variants
- Include with the same value for item_group_id and different values for material
|
pattern |
Required if relevant for distinguishing different products in a set of variants
Optional for all other products
Your product’s pattern or graphic print
|
- For variants
- Include with the same value for item_group_id and different values for pattern
|
size |
Required for all apparel items in the Apparel & Accessories > Clothing and Apparel & Accessories > Shoes product categories focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different sizes
Optional for all other products and countries of sale
Your product’s size
|
- For variants
- Include with the same value for item_group_id and different values for size
- If sizes contain multiple dimensions, condense them into 1 value. For example, “16/34 Tall” for neck size 16 inches, sleeve length 34 inches, and “Tall” fit
- If your item is one size fits all or one size fits most, you can use one size, OS, one size fits all, OSFA, one size fits most, or OSFM
|
item_group_id |
Required for Brazil, France, Germany, Japan, the United Kingdom, and the US if the product is a variant
Optional for all other products and countries of sale
ID for a group of products that come in different versions (variants)
|
- Use a unique value for each group of variants. Use the parent SKU where possible
- Keep the value the same when updating your product data
- Use only valid unicode characters
- Use an item group ID for a set of products that differ by one or more of these attributes:
- color
- size
- pattern
- material
- age group
- gender
- Include the same attributes for each product in the item group. For example, if a product varies by size and color, submit sizeand color for every product that share the same value for item_group_id
- If your products differ by design elements that aren’t represented by the attributes above, don’t use item_group_id
|
custom_label_0 |
Optional but recommended
Label that you assign to a product to help organize bidding and reporting in Shopping campaigns
Example
- seasonal
- clearance
- holiday
- sale
- price range
|
- Use a value that you’ll recognize in your Shopping campaign. The value won’t be shown to users who see your ads
- Submit up to 5 custom labels per product by including this attribute multiple times:
- custom_label_0
- custom_label_1
- custom_label_2
- custom_label_3
- custom_label_4
|