Product detail [product_detail]

An illustration demonstrating the various product details of a Google Pixel phone.

Use the product detail [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 potential customers with readable, structured data and enhances our ability to show individual products based on those customers’ queries.

When to use

Required Required for each product.

If you are using the automated discounts or dynamic promotions feature, you must use the auto pricing minimum price [auto_pricing_min_price] attribute to specify the minimum price to which your product can be reduced.

This attribute has 3 sub-attributes:
  • Section name [section_name] (Optional but recommended)
  • Attribute name [attribute_name] (Required)
  • Attribute value [attribute_value] (Required)

Format

Follow these formatting guidelines to make sure Google understands the data you're submitting.

For details on when and how to submit values in English, learn more about submitting your product data.

Type String (Unicode characters. Recommended: ASCII only)
Sub-attributes
  • section_name (Optional but recommended)
  • attribute_name (Required)
  • 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 (TSV) 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>

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 your product on Google. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Manufacturer Center account.

  • Each product detail [product_detail] has 3 required sub-attributes: section name [section_name], attribute name [attribute_name], and attribute value [attribute_value].
    • The product detail attribute is optional.
    • If you use the product detail attribute, you must also submit all sub-attributes.
    • All sub-attributes must be submitted as a part of the product detail [product_detail] attribute, not individually.
  • When submitting text (or TSV) files, make sure to format product details correctly.
    • Each product detail [product_detail] attribute must use colons to separate the three sub-attributes.
      • The correct format is section name:attribute name: attribute value.
      • If there is no section name, then the correct format is to start with a colon ( : ). For example, “:attribute name: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.

  • Avoid adding promotional text or information covered in other attributes. 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 [sale_price] or shipping [shipping].
  • Only provide an attribute name and value when the value is confirmed. For example, for a food product, only provide a value such as “Vegetarian=False” if it is confirmed the product is not vegetarian, and not just because "False" is the default value for Boolean attributes.
  • Avoid listing keywords or search terms. Only list relevant details and specifications of the product.

Example

ID [id] 1
Brand [brand] Brand A
Title [title] Digital player
GTIN [gtin] 468013579357
Product detail [product_detail] General:Product Type:Digital player
Product detail [product_detail] General:Digital Player Type:Flash based
Product detail [product_detail] Display:Resolution:432 x 240
Product detail [product_detail] Display:Diagonal Size:"2.5"""

Best practices

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

  • Use sentence case when submitting values for the attribute. For example, use “Focal length” rather than “focal length” or “Focal Length”.
  • 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 [section_name] and attribute name [attribute_name] combinations you might include for different types of products. Note that this is not a comprehensive or an exhaustive list. You are welcome to add additional properties when they are applicable to your products.

Mobile Phones

Product data for a mobile phone with 64 GB Flash memory and battery capacity of 12.5 hours
Attribute Value
Product detail [product_detail] General:Dimensions:20x5 cm.
Product detail [product_detail] General:Integrated Components:"Camera,Microphone"
Product detail [product_detail] General:Protection:Scratch-resistant display
Product detail [product_detail] Cellular:Technology:"GSM,CDMA"
Product detail [product_detail] Cellular:Band:"4G:1900, 1700/2100, 850, 700, 2300"
Product detail [product_detail] Memory:64 GB Flash
Product detail [product_detail] Battery:Capacity:12.5 hours
Product detail [product_detail] Battery:Charge:"1,440 mAh"

Digital Cameras

 

Product data for a camera bundle with body and 24-105mm - F/4.0 lens
Attribute Value
ID [id] camera1-bundle-A
Item group ID [item_group_id] camera1
Product detail [product_detail] Body Features:Sensor:CMOS
Product detail [product_detail] Body Features:Processor:ABCD Image processor
Product detail [product_detail] Lens System:Focal length:24-105mm
Product detail [product_detail] Body Features:Video:1080p full HD 60 fps
Product detail [product_detail] Lens System:Aperture range:F/4.0

 

Product data for a camera bundle with the same body but a different (fixed 50mm - F/1.8) lens
Attribute Value
ID [id] camera1-bundle-B
Item group ID [item_group_id] camera1
Product detail [product_detail] Body Features:Sensor:CMOS
Product detail [product_detail] Body Features:Processor:ABCD Image processor
Product detail [product_detail] Body Features:Video:1080p full HD 60 fps
Product detail [product_detail] Lens System:Focal length:50mm
Product detail [product_detail] Lens System:Aperture range:F/1.8

Laptops

 

Product data for a 13 inch laptop with 2 GB RAM and a Lithium-Ion Battery
Attribute Value
Product detail [product_detail] Display:Size:13 inch
Product detail [product_detail] Processor:CPU:Nvidia Tegra K1 (armV7)
Product detail [product_detail] Memory:Flash:16GB SSD
Product detail [product_detail] Battery:Capacity:Runs for 7 hours on an online streaming video test
Product detail [product_detail] Battery:Technology:Lithium-Ion
Product detail [product_detail] Memory:RAM:2GB

Vitamins

 

Product data for 60 capsules of multivitamins
Attribute Value
Product detail [product_detail] General: Capsules: 0
Product detail [product_detail] General:Directions:Take in the morning with food
Product detail [product_detail] General:Ingredients:"Vitamin C, Vitamin D, Iron, Niacin, Citric acid, Natural fruit extract"
Product detail [product_detail] Nutrition Facts:Calories:0
Product detail [product_detail] Nutrition Facts:Serving Size:2 capsules

Cosmetics

Product data for facial moisturizer
Attribute Value
Product detail [product_detail] : Instructions:Apply to clean skin in the morning and at night
Product detail [product_detail] : Ingredients:"Organic rose essential oil, mineral water"
Product detail [product_detail] : Shelf life:1 year

Furniture

Product data for a sofa
Attribute Value
Product detail [product_detail] General:Product weight:105 pounds (US)
Product detail [product_detail] Additional Details:Capacity:1 person
Product detail [product_detail] Additional Details:Assembly info:"Self-assembly required, necessary tools and instructions included. Optional: Expert assembly available for an additional fee of $35."

Was this helpful?

How can we improve it?

Need more help?

Try these next steps:

false
Search
Clear search
Close search
Google apps
Main menu
18355461765476904649
true
Search Help Center
true
true
true
true
true
104514
false
false