Documentation Home

Google PLA Data Field Mappings

Google Field BLC Field/Table Required Description
id SKU_ID / BLC_SKU Yes Use the id attribute to uniquely identify each product. The ID won’t be shown to users who view your ads.
title NAME / BLC_SKU Yes Use the title attribute to clearly identify the product you’re selling. The title is one of the most prominent parts of your ad. A specific and accurate title will help us show your product to the right users.
description LONG_DESCRIPTION / BLC_SKU Yes Use the description attribute to tell users about your product. List product features, technical specifications, and visual attributes. A detailed description will help us show your product to the right users.
google_product_category TARGET_CATEGORY_ID / BLC_DATA_FEED_CATEGORY_MAPPING Yes, if Apparel, Media, or Software Use the google_product_category attribute to indicate the category of your item based on the Google product taxonomy. Categorizing your product helps ensure that your ad is shown with the right search results.
product_type CATEGORY_ID / CATEGORY_PRODUCT_XREF No Use the product_type attribute to include your own product categorization system in your product data.
link URL / BLC_PRODUCT Yes When users click your ad, they’re sent to a landing page (URL) on your website for the advertised product.
image_link URL / BLC_MEDIA Yes Include the URL for your main product image with the image_link attribute. This image appears to potential customers in ads for your product.
condition ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes Tell users about the condition of the product you're selling. Setting this value correctly is important since we use it to refine search results. Must be one of the following: new, refurbished, used
availability INVENTORY_TYPE and QUANTITY_AVAILABLE / BLC_SKU Yes Use the availability attribute to tell users and us whether you have a product in stock. Must be one of the following: in stock, out of stock, preorder
price RETAIL_PRICE / BLC_SKU Yes Use the price attribute to tell users how much you’re charging for your product. This information is shown to users in your ads.
gtin UPC / BLC_SKU Yes Use the gtin attribute to submit Global Trade Item Numbers (GTINs). A GTIN uniquely identifies your product. SKU is a form of a GTIN.
brand MANUFACTURE / BLC_PRODUCT Yes Use the brand attribute to indicate the product's brand name. The brand is used to help identify your product and will be shown to users who view your ad.
item_group_id PRODUCT_ID / BLC_PRODUCT Yes, if there are variations of the same product Use the item_group_id attribute to group product variants in your product data. Variants are a group of similar items that only differ from one another by product details like size, color, material, pattern, age_group, size_type, and size_system.
color ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Use the color attribute to describe your product’s color. This information helps create accurate filters, which users can use to narrow search results. If your product has variants that vary by color, then provide that information through this attribute.
gender ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Specify the gender your product is designed for using the gender attribute. When you provide this information, potential customers can accurately filter products by gender to help narrow their search. Keep in mind that we also use the gender information together with the values you provide for size and age_group to standardize the sizes that are shown to users.
age_group ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel When you use this attribute, your ad can appear in results that are filtered by age. For example, if results are filtered by Women instead of Girls. The age_group can also work together with the gender to help ensure that users see the correct size information.
size ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Use the size attribute to describe the standardized size of your product. When you use this attribute, your ad can appear in results that are filtered by size. The size you submit will also affect how your product variants are shown.
shipping RATE / BLC_SKU_FULFILLMENT_FLAT_RATES Yes, when you need to override the shipping settings that you set up in Merchant Center The shipping attribute lets you provide shipping cost for a product.
shipping_weight WEIGHT / BLC_SKU No, but recommended if you have shipping settings set up in Merchant Center that calculate costs based on weight The shipping_weight attribute let’s you include the weight to use when calculating shipping costs through your Merchant Center settings. For example, you would use shipping_weight when using carrier-calculated rates.
shipping_length DEPTH / BLC_SKU No, but recommended if you have shipping settings set up in Merchant Center that calculate costs based on dimensions Enter the dimensions of the package for your product using the shipping_length, shipping_width, and shipping_height attributes. These 3 attributes help determine the shipping cost if you’re using a carrier-calculated shipping method in Merchant Center.
shipping_width WIDTH / BLC_SKU No, but recommended if you have shipping settings set up in Merchant Center that calculate costs based on dimensions Enter the dimensions of the package for your product using the shipping_length, shipping_width, and shipping_height attributes. These 3 attributes help determine the shipping cost if you’re using a carrier-calculated shipping method in Merchant Center.
shipping_height HEIGHT / BLC_SKU No, but recommended if you have shipping settings set up in Merchant Center that calculate costs based on dimensions Enter the dimensions of the package for your product using the shipping_length, shipping_width, and shipping_height attributes. These 3 attributes help determine the shipping cost if you’re using a carrier-calculated shipping method in Merchant Center.
shipping_label ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE No, but recommended if you have shipping settings set up in Merchant Center that set shipping costs based on a label Use the shipping_label attribute to group products together so that you can configure specific shipping rates in Merchant Center. The information you include in this attribute won’t be shown to users.
adult ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes Use the adult attribute to indicate that individual products are for adults only because they contain adult content such as nudity, sexually suggestive content, or are intended to enhance sexual activity. Must be one of the following: yes or no

Google LIA Data Field Mappings

Note: Requires two feeds - one for the products, and the other for inventory

Google Product Feed

Google Field BLC Field/Table Required Description
id SKU_ID / BLC_SKU Yes Use the id attribute to uniquely identify each product. The ID won’t be shown to users who view your ads.
title NAME / BLC_SKU Yes Use the title attribute to clearly identify the product you’re selling. The title is one of the most prominent parts of your ad. A specific and accurate title will help us show your product to the right users.
description LONG_DESCRIPTION / BLC_SKU Yes Use the description attribute to tell users about your product. List product features, technical specifications, and visual attributes. A detailed description will help us show your product to the right users.
google_product_category TARGET_CATEGORY_ID / BLC_DATA_FEED_CATEGORY_MAPPING Yes, if Apparel, Media, or Software Use the google_product_category attribute to indicate the category of your item based on the Google product taxonomy. Categorizing your product helps ensure that your ad is shown with the right search results.
image_link URL / BLC_MEDIA Yes Include the URL for your main product image with the image_link attribute. This image appears to potential customers in ads for your product.
condition ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes Tell users about the condition of the product you're selling. Setting this value correctly is important since we use it to refine search results. Must be one of the following: new, refurbished, used
gtin UPC / BLC_SKU Yes Use the gtin attribute to submit Global Trade Item Numbers (GTINs). A GTIN uniquely identifies your product. SKU is a form of a GTIN.
brand MANUFACTURE / BLC_PRODUCT Yes Use the brand attribute to indicate the product's brand name. The brand is used to help identify your product and will be shown to users who view your ad.
item_group_id PRODUCT_ID / BLC_PRODUCT Yes, if there are variations of the same product Use the item_group_id attribute to group product variants in your product data. Variants are a group of similar items that only differ from one another by product details like size, color, material, pattern, age_group, size_type, and size_system.
color ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Use the color attribute to describe your product’s color. This information helps create accurate filters, which users can use to narrow search results. If your product has variants that vary by color, then provide that information through this attribute.
gender ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Specify the gender your product is designed for using the gender attribute. When you provide this information, potential customers can accurately filter products by gender to help narrow their search. Keep in mind that we also use the gender information together with the values you provide for size and age_group to standardize the sizes that are shown to users.
age_group ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel When you use this attribute, your ad can appear in results that are filtered by age. For example, if results are filtered by Women instead of Girls. The age_group can also work together with the gender to help ensure that users see the correct size information.
size ATTRIBUTE_VALUE / BLC_PRODUCT_OPTION_VALUE Yes, if it is a variation, or the category is Apparel Use the size attribute to describe the standardized size of your product. When you use this attribute, your ad can appear in results that are filtered by size. The size you submit will also affect how your product variants are shown.

Google Inventory Feed

Google Field BLC Field/Table Required Description
store code SKU_ID / BLC_STORE Yes A unique alphanumeric identifier for each local store. You must use the same store codes that you provided in your Google My Business account.
itemid SKU_ID / BLC_SKU Yes Use the id attribute to uniquely identify each product. The ID won’t be shown to users who view your ads.
price RETAIL_PRICE / BLC_SKU Yes Use the price attribute to tell users how much you’re charging for your product. This information is shown to users in your ads.
quantity QUANTITY_AVAILABLE / BLC_SKU Yes The number of items in stock for the store.