A product description page (PDP) teaches shoppers about your product's features and benefits before they complete their purchase with Buy on Google. You can create rich PDPs by uploading rich product data via the Content API for Shopping. Rich product data includes information about the product's features and benefits, product variants, and product images. Additional benefits of rich product data include: - Improving product discovery by providing more detailed product descriptions to help customers find products that meet their needs - Increasing customer trust by providing accurate product information that enables confident purchase decisions - Helping improve conversion by more clearly conveying the value of a product to customers This guide explains how to use the Content API to upload rich product data when creating products using the [`products.insert`](https://developers.google.com/shopping-content/reference/rest/v2.1/products) method. The following sections provide partial request bodies containing the attributes for the [`products`](https://developers.google.com/shopping-content/reference/rest/v2.1/products) resource that make up rich product data. For a complete JSON request, see [Example: Uploading rich product data using products.insert](https://developers.google.com/shopping-content/guides/products/rich-product-data#example). > [!NOTE] > **Note:** For more information on rich product description pages, including how to add rich product data in Merchant Center, see [Create rich product description pages for Buy on Google](https://support.google.com/merchants/answer/9479464). ## Product ID attributes A product's [`id`](https://developers.google.com/shopping-content/reference/rest/v2.1/products#Product.FIELDS.id) attribute, also known as the `REST ID`, is a unique identifier that is derived from the values that you provide for the `channel`, `contentLanauge`, `feedLabel`, and `offerId` attributes. For example, `online:en:US:1111111111`. For rich product data, include values for all of the product ID attributes: - `channel`: "online" or "local" - `contentLanguage`: The two-letter language code, such as "en" or "fr" - `feedLabel`: The two-letter language code, such as "US" or "FR" - `offerId`: A unique identifier string provided by the merchant ### Sample request "channel": "online", "contentLanguage": "en", "targetCountry": "US", "feedLabel": "US", "offerId": "1111111111" ## Product title Putting key product details, such as information about brand, gender, size, and color, in the `title` attribute helps customers quickly determine whether they are looking at the right product. For additional guidelines and requirements for product titles, see [title: Definition](https://support.google.com/merchants/answer/6324415). ### Sample request "title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White" ## Product description A rich product description, provided via the `description` attribute, can help educate customers about the product in ways that specifications and images can't. For additional guidelines and requirements for product descriptions, see [description: Definition](https://support.google.com/merchants/answer/6324468). > [!NOTE] > **Note:** Google may format product descriptions based on matches with the product's unique GTIN. ### Sample request "description": "The Google phone. MotionSense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way." ## Product images Enhance your product description pages by providing product images via the `imageLink` and `additionalImageLinks` attributes. We recommend providing multiple high-quality images showing the product from different angles and in different contexts. For additional guidelines and requirements for product images, see [image_link: Definition](https://support.google.com/merchants/answer/6324350). ### Sample request "imageLink": "https://example.com/gallery/500/image1.jpg", "additionalImageLinks": [ "https://example.com/gallery/500/image2.jpg", "https://example.com/gallery/500/image3.jpg", "https://example.com/gallery/500/image4.jpg", "https://example.com/gallery/500/image5.jpg" ] ## Product variants You can use the `itemGroupId` attribute to define product groups for variants of similar products. For guidelines on how and when to group products, as well as requirements and best practices, see [item_group_id: Definition](https://support.google.com/merchants/answer/6324507). ### Sample request "itemGroupId": "pixels" ## Product highlights The product highlights section on a product description page shows a short, bulleted list of product details next to the main product image. Use the `productHighlights` attribute to provide a list of items for the product highlights section. We recommend providing at least five product highlights. For additional guidelines and requirements for product highlights, see [product_highlights: Definition](https://support.google.com/merchants/answer/9216100). > [!NOTE] > **Note:** Google may modify the content of the product highlights section based on matches with the product's unique GTIN. ### Sample request "productHighlights": [ "6GB RAM lets you enjoy multitasking conveniently", "Touch screen feature offers user friendly interface", "Its 16MP and 12MP rear cameras allow you capture high-quality pictures" ] ## Product details The product details section on a product description page shows additional product information below the product image (the layout may differ between desktop and mobile pages). Use the `productDetails` attribute to provide a list of product details objects, each of which includes a `sectionName`, `attributeName`, and `attributeValue` attribute. We recommend providing at least six product details. For additional guidelines and requirements for product details, see [product_detail: Definition](https://support.google.com/merchants/answer/9218260). > [!NOTE] > **Note:** The provided product details must match the details for the products GTIN. ### Sample request "productDetails": [ { "sectionName": "General", "attributeName": "Product Type", "attributeValue": "Smartphone" }, { "sectionName": "Display", "attributeName": "Resolution", "attributeValue": "FHD Display 6GB RAM" } ] ## Unique product identifiers (GTIN, brand, MPN) Google uses unique product identifiers to identify products. We strongly recommend providing a [GTIN](https://support.google.com/merchants/answer/6324461) value for each of your products. If you do not provide a GTIN, you must provide values for both [brand](https://support.google.com/merchants/answer/6324351) and [MPN](https://support.google.com/merchants/answer/6324482) so that we can identify your product. For more information about identifier types, see [About unique product identifiers](https://support.google.com/merchants/answer/160161). > [!NOTE] > **Note:** Google identifiers are also used to match products with review data, if available. For more information on providing review data, see [Product Ratings submission options](https://support.google.com/merchants/answer/7045996). ### Sample request "gtin": "842776114952", "brand": "Google", "mpn": "GA01188-US" ## Example: Upload rich product data with `products.insert` The following JSON sample shows an example of a request for a `products.insert` call for uploading rich product data. > [!WARNING] > **Warning:** By default, making calls to `products.insert` to update existing products replaces all of the product data with the fields provided in the body of the request. For details on updating products without replacing existing product data, see [Supplemental Feeds](https://developers.google.com/shopping-content/guides/products/supplemental-feeds). POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products { "channel": "online", "contentLanguage": "en", "offerId": "pixel4", "targetCountry": "US", "feedLabel": "US", "title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White", "description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.", "imageLink": "https://example.com/gallery/500/image1.jpg", "additionalImageLinks": [ "https://example.com/gallery/500/image2.jpg", "https://example.com/gallery/500/image3.jpg", "https://example.com/gallery/500/image4.jpg", "https://example.com/gallery/500/image5.jpg" ], "brand": "Google", "googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones", "gtin": "842776114952", "mpn": "GA01188-US", "price": { "currency": "USD", "value": "549.99" }, "salePrice": { "currency": "USD", "value": "549.99" }, "productHighlights": [ "6GB RAM lets you enjoy multitasking conveniently", "Touch screen feature offers user friendly interface", "Its 16MP and 12MP rear cameras allow you capture high-quality pictures" ], "productDetails": [ { "sectionName": "General", "attributeName": "Product Type", "attributeValue": "Smartphone" }, { "sectionName": "Display", "attributeName": "Resolution", "attributeValue": "FHD Display 6GB RAM" } ], "availability": "in stock", "condition": "new", "includedDestinations": [ "Shopping Actions" ], "excludedDestinations": [ "Shopping Ads" ], "sellOnGoogleQuantity": 100, "shippingLabel": "US_Test" }