product_detail: Definition

Use the product_detail attribute to provide technical specifications or additional details. You can describe any aspect of the product not explicitly covered by other attributes. This attribute provides shoppers with readable, structured data and enhances our ability to surface individual products based on user queries.

When to use

Optional for each product

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type String (Unicode characters. Recommended: ASCII only)
Sub-attributes Section name [section_name] (Optional)
Attribute name [attribute_name] (Required)
Attribute value [attribute_value] (Required)
Limits Section name: up to 140 characters recommended 
Attribute name: up to 140 characters recommended 
Attribute value: up to 1,000 characters
Repeated field Yes, up to 1000

 

File format Example value
Text feeds General:Product Type:Digital player,General:Digital Player Type:Flash based,Display:Resolution:432 x 240,Display:Diagonal Size:"2.5"""
XML feeds <g:product_detail>
    <g:section_name>General</g:section_name>
    <g:attribute_name>Product Type</g:attribute_name>
    <g:attribute_value>Digital player</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>General</g:section_name>
    <g:attribute_name>Digital Player Type</g:attribute_name>
    <g:attribute_value>Flash based</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>Display</g:section_name>
    <g:attribute_name>Resolution</g:attribute_name>
    <g:attribute_value>432 x 240</g:attribute_value>
</g:product_detail>
<g:product_detail>
    <g:section_name>Display</g:section_name>
    <g:attribute_name>Diagonal Size</g:attribute_name>
    <g:attribute_value>2.5"</g:attribute_value>
</g:product_detail>


If you choose to use the Content API to add this attribute, you’ll need to use the custom attributes feature.

Content API
(JSON)
"customAttributes": [
  {
    "name": "product detail",
    "groupValues": [
      {
        "name": "section name",
        "value": "General"
      },
      {
        "name": "attribute name",
        "value": "Product Type"
      },
      {
        "name": "attribute value",
        "value": "Digital player"
      }
    ],
    {
      "name": "product detail",
      "groupValues": [
        {
          "name": "section name",
          "value": "General"
        },
        {
          "name": "attribute name",
          "value": "Digital Player"
        },
        {
          "name": "attribute value",
          "value": "Flash Based"
        }
      ]
    }
  ]

Learn more about the Content API for Shopping

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • Each product_detail has 3 sub-attributes. They are section_name, attribute_name, and attribute_value.
    • section_name is optional but strongly recommended.
    • attribute_name and attribute_value are always required for each product_detail you submit.
  • When submitting text feeds, make sure to format product details correctly.
    • Each product detail attribute must contain 2 colons to separate the three sub-attributes.The correct format is section name [section_name]:attribute name [attribute_name]:attribute value [attribute_value].
      • If there is no section name then the correct format is to start with a ":". As in the example below.
        • :attribute name [attribute_name]:attribute value [attribute_value]
    • Multiple product_detail values for a single item should be separated by commas. 
    • If any of the sub-attributes contains a comma or a colon, you must enclose that sub-attribute in straight double quotes; any straight double quotes within that sub-attribute must be doubled.
  • Don't add information covered in other attributes or promotion text. Don’t add information such as price, sale price, sale dates, shipping, delivery date, other time-related information, or your company’s name. Include this information with the other attributes such as sale price or shipping. 
  • Don't list keywords or search terms. Only list relevant details and specifications of the product. 

Best practices

These are best practices that can help you go beyond the basic requirements to optimize your product data for performance. 

  • Do not duplicate data within the attribute.
  • Do not use search engine optimization (SEO) keywords.
  • Check for errors in grammar, spelling, or capitalization.

Examples

Here are some examples of the section_name and attribute_name combinations you might include for different types of products. Note that this is not a comprehensive or exhaustive list. You are welcome to add additional properties when they are applicable to your products.

Mobile Phones

An illustration with 3 different colors of one mobile phone
  • General
    • Dimensions
    • Integrated Components
    • Protection
  • Cellular
    • Technology
    • Band
    • Service Provider
  • Communications
    • Data Transmission
    • LTE Band
    • Wireless Interface
    • Bluetooth
  • Memory
    • RAM
  • Display
    • Sensor Resolution
    • Display Resolution
  • Battery
    • Capacity
    • Runtime details

Digital Cameras

Camera bundle
  • Exposure & White Balance
    • Light Sensitivity
    • Exposure Metering
    • Shutter Speed
  • Lens System
    • Type
    • Focal Adjustment
    • Feature
    • Note: Use the “lens system” property for different types of lens bundled with the camera. Make sure to include the “body only” camera in the same item group id to ensure products are grouped correctly. For example:
  • Product 1 - Camera body only
    • id: camera1-body
    • item group id: camera1
    • product detail:
      • section name: lens system
        • attribute name: type, attribute value: [value]
        • attribute name: focal adjustment, attribute value: [value]
        • attribute name: features, attribute value: [value]
  • Product 2 - Camera bundle with body and 50mm - F/1.8 lens
    • id: camera1-bundle-C
    • item group id: camera1
    • product detail:
      • section name: lens system
        • attribute name: type, attribute value: [value]
        • attribute name: focal adjustment, attribute value: [value]
        • attribute name: features, attribute value: [value]
  • Product 3 - Camera bundle with body, 50mm - F/1.8 lens and 24-105mm - F/4.0 lens
    • id: camera1-bundle-D
    • item group id: camera1
    • product detail:
      • section name: lens system
        • attribute name: type, attribute value: [value]
        • attribute name: focal adjustment, attribute value: [value]
        • attribute name: features, attribute value: [value]

Laptops

  • General
    • Operating System
    • Size
  • Processor
    • CPU
  • Memory
    • Flash
    • RAM
  • Battery
    • Technology
    • Capacity

Vitamins

  • General
    • Units
    • Directions
    • Ingredients
  • Nutrition Facts
    • Serving Size

Cosmetics

  • General
    • Instructions
    • Ingredients
  • Characteristics
    • Shelf life

Furniture

  • General
    • Item weight
    • Shipping weight
  • Additional Details
    • Capacity
    • Assembly info
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue