Notification

In this Help Centre, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure that you're using the article for the Merchant Center version that applies to you. 

Product detail [product_detail]

Use the product detail [product_detail] attribute to provide technical specifications or additional details. You can describe any aspect of the product that is not explicitly covered by other attributes. This attribute provides customers with readable, structured data and enhances our ability to show individual products based on their queries.

In this article

When to use

OptionalOptional for each product

Sub-attributes

This attribute has three 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 that Google understands the data that you're submitting.

Learn when and how to submit your product data in English

Type String (Unicode characters. Recommended: ASCII only)

Sub-attributes

  • section_name (Optional)
  • 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 1,000
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>

To format your data for Content API, see the Content API for Shopping resource.

Learn more about product detail in Content API shopping.

Note: To ensure that this product data attribute is recognised by our system correctly, remember to submit your data feed file in a format that we support.

Minimum requirements

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

When submitting text feeds, make sure that you format product details correctly

Each product detail [product_detail] attribute must contain two colons to separate the three sub-attributes.

  • The correct format is: section_name:attribute_name:attribute_value
  • If there is no section name [section_name] then the correct format is to start with a colon (:), for example :attribute_name:attribute_value
  • Avoid adding information covered in other attributes or promotion text. Don't add information such as price, sale price, sale dates, delivery, 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 delivery [shipping].
  • Only provide an attribute name and value when the value is confirmed. For example, for a food product, only provide 'Vegetarian:False' if it is confirmed that the product is indeed 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.

Learn more about how to set up your product data in Google Sheets.

Best practices

These best practices can help you to go beyond the basic requirements to optimise 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 optimisation (SEO) keywords.
  • Check for errors in grammar, spelling or capitalisation.

Examples

Here are some examples of the section name and attribute name combinations that 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.

Clothing

Product data for running shoes made of recycled material
Attribute Value
Product detail [product_detail] Sustainability:material:recycled
Product data for a jacket made of organic material
Attribute Value
Product detail [product_detail] Sustainability:material:organic

Appliances

Product data for a clothes dryer with Energy Star certification
Attribute Value
Product detail [product_detail] Sustainability:Certification:Energy Star

Mobile phones

An illustration with 3 different colors of one mobile phone
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] Mobile:Technology:"GSM,CDMA"
Product detail [product_detail] Frequency: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

Camera bundle
Product data for a camera bundle with body and 24–105 mm – 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–105 mm
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 50 mm - 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:50 mm
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:16 GB 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:2 GB

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 moisturiser
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?
true
Search
Clear search
Close search
Google apps
Main menu
1470719468374230730
true
Search Help Centre
true
true
true