Product detail [product_detail]

Use the product detail [product_detail] attribute to provide technical specifications or other additional details. You can describe any aspect of the product 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.

By submitting this attribute, you can help customers discover information about your products across AI-driven surfaces, like AI Mode in Google Search and more while also enhancing traditional search experiences.

In this article

When to use

OptionalOptional for each product

Sub-Attributes

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.

Learn when and how to submit your product data in English

File format Example value
Text

Note: TSV (tab separated) text file is recommended.

Header: Format the attribute header by including the sub-attributes you’re submitting. Include product detail [product_detail], and then, in parentheses, add the names of the sub-attributes that you want to submit separated by a colon ( : ). Don't use quotation marks in the header.

Value: Format the value by submitting the value of each sub-attribute listed in the same order as in the header and separated by a colon ( : ).

For example, to submit attribute_name and attribute_value:

Header: product_detail (attribute_name:attribute_value)

Possible value: Warranty:1 year manufacturer

If you name the sub-attributes you're using in the header, you can give them to us in any order. However, if you don’t name them (and only provide the attribute name), we’ll assume that your attribute values include the required sub-attributes in this order:

  1. Section name [section_name]
  2. Attribute name [attribute_name]
  3. Attribute value [attribute_value]

For example, to submit section name, attribute_name, and attribute_value:

Header: product_detail

Possible value: General:Product Type:Digital player,General:Digital Player Type:Flash based,Display:Resolution:432 x 240,Display:Diagonal Size:"2.5"""

If you don’t need to provide the section name [section_name] optional sub-attribute for some attribute values, then still add a colon ( : ) in the front, but leave the corresponding first sub-attribute value blank. For example:

Header: product_detail

Possible values: :Warranty:1 year manufacturer

Note: Always provide the same number of sub-attributes as you are submitting in the header. Missing sub-attributes in the header will lead to formatting errors and you will find a warning "Invalid format for sub-attributes [product_detail]" in the "Needs attention" tab.
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 Merchant API, view the Merchant API for Shopping resource.

Important: As this is a repeated group attribute, pay careful attention to the formatting requirements when your sub-attribute values contain special characters (colons, commas, quotes, and backslashes). Refer to the detailed formatting example at the end of this article.

  • For text feeds, follow the detailed instructions related to quoted attributes in text feeds.
    • We recommend using the TSV (tab-separate values) format for text files instead of CSV (comma-separated values) due to complexities of processing the comma symbol.
For Google sheets, follow the detailed instructions related to escaping characters in Google sheets.
Note: To ensure that this product data attribute gets recognized by our system correctly, remember to submit your data source file in a format that we support.

Minimum requirements

These are the requirements 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 to format product details correctly

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

  • Avoid adding 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 [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 “Vegetarian:False” if it is confirmed 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 go beyond the basic requirements to optimize your product data for performance.

  • Use the attribute for a wide variety of product-specific information that is relevant for a customer, for example: package contents, connectivity, ingredient lists, installation instructions, power requirements, feature lists.
  • This attribute can also be used to submit salient products fact and features as key-value pairs, for example:
    • Shape: To describe the shape of a product, e.g., a piece of art or furniture
    • Occasion: Special occasion(s) the product is intended for, e.g., celebrations or holidays
    • Sport: Certain sport(s) the product is intended for
    • Finish: The external treatment(s) of the product to change its appearance or texture, e.g. for furniture
    • Activity: An activity/activities for which the product is intended, e.g., gardening
    • Format: The format of the product, e.g., for books or media such as music
    • Theme: A theme that your product is associated with
    • Scent: Scent(s) or fragrances (s) of the product
    • Flavor: Flavor(s) or taste of the product
  • Use sentence case when submitting values for the attribute. For example, use “Focal length” rather than “focal length” or “Focal Length”.
  • Don't use search engine optimization (SEO) keywords.
  • Check for errors in grammar, spelling, or capitalization.
  • Don't duplicate data within the attribute or data that you have already submitted in other attributes, such as title [title], description [description], question_and_answer [question_and_answer], or product highlight [product_highlight].
  • Don't submit if you are also submitting the document link [document_link] attribute and the same information can be found in these documents. We will extract FAQ information from those documents instead.

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.

Apparel

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] 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

Camera bundle
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 USD."

Detailed formatting example

Let's say you want to submit the product details [product_detail] group attribute for a camera you are selling, with the following content, consisting of 4 sections (1 of which without a specific section name) and 14 values (rows) in total:

section_name

attribute_name

attribute_value

Connectivity

Connectivity Technology

HDMI, NFC, USB

Connectivity

Wireless Technology

BuiltIn 802.11b/g/n with NFC

Connectivity

Video Output

Type C Mini HDMI

Connectivity

Total Video Out Ports

2

Memory

Flash Memory Type:

Single Slot: SD/SDHC/SDXC (UHS-I)

Memory

Recording Capacity

30 Minutes

Memory

Write Speed

Several MB/s to over 100 MB/s

Memory

Windows Directory

C:\\camera\defaults

Camera Settings

Metering Methods

average,multi-zone,partial,spot

Camera Settings

Exposure Control

Auto, Manual, Program, Shutter Priority

Camera Settings

Crop Mode

APS-C, max. 12"

 

What's in the box?

Camera Body,Lens,Battery pack,Manual

 

Warranty

1 year manufacturer

 

Best Sellers Rank

1,065 in Electronics,#1 in DSLR Cameras

Formatting using a tab-separated text file

You’d submit this in one cell like this (note that values containing commas and colons are quoted, and that quotes are double quoted). Tab characters are represented by the <tab> symbol:

Header: <tab>product_detai<tab>

product row: <tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB",Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,Connectivity:Video Output:Type C Mini HDMI,Connectivity:Total Video Out Ports:2,Memory:Flash Memory Type:"Single Slot: SD/SDHC/SDXC (UHS-I)",Memory:Recording Capacity:30 Minutes,Memory:Write Speed:Several MB/s to over 100 MB/s,Memory:Windows Directory:"C:\\camera\defaults",Camera Settings:Metering Methods:"average,multi-zone,partial,spot",Camera Settings:Exposure Control:"Auto, Manual, Program, Shutter Priority",Camera Settings:Crop Mode:"APS-C max. 12""",:What's in the box?:"Camera Body,Lens,Battery pack,Manual",:Warranty:1 year manufacturer,:Best Sellers Rank:"#1,065 in Electronics,#1 in DSLR Cameras"<tab>

Alternatively, you can also create multiple separate columns, each containing one or more values. For example, to have one column for each section, you can submit this in 4 tab-separated columns as follows:

Header: <tab>product_detail <tab>product_detail<tab>product_detail<tab>product_detail<tab>

Product row: <tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB",Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,Connectivity:Video Output:Type C Mini HDMI,Connectivity:Total Video Out Ports:2<tab>Memory:Flash Memory Type:"Single Slot: SD/SDHC/SDXC (UHS-I)",Memory:Recording Capacity:30 Minutes,Memory:Write Speed:Several MB/s to over 100 MB/s,Memory:Windows Directory:"C:\\camera\defaults"<tab>Camera Settings:Metering Methods:"average,multi-zone,partial,spot",Camera Settings:Exposure Control:"Auto, Manual, Program, Shutter Priority",Camera Settings:Crop Mode:"APS-C max. 12"""<tab>:What's in the box?:"Camera Body,Lens,Battery pack,Manual",:Warranty:1 year manufacturer,:Best Sellers Rank:"#1,065 in Electronics,#1 in DSLR Cameras"<tab>

Lastly, you can also submit each value in its individual column, in which case you would need 14 columns as follows (only 3 columns shown), with a tab separating each column:

Header: <tab>product_detail <tab>product_detail<tab>product_detail<tab>

Product row: <tab>Connectivity:Connectivity Technology:"HDMI, NFC, USB"<tab>Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC<tab>Connectivity:Video Output:Type C Mini HDMI <tab>

Formatting using a Google sheet

You’d submit this in one cell like this. (Note the escaping of commas, colons, and backslashes that are part of the attribute value, indicated in red in the above table, with a backslash (\):

 

N

O

P

1

product_detail

2

Connectivity:Connectivity Technology:HDMI\, NFC\, USB,

Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,

Connectivity:Video Output:Type C Mini HDMI,

Connectivity:Total Video Out Ports:2,

Memory:Flash Memory Type:Single Slot\: SD/SDHC/SDXC (UHS-I),

Memory:Recording Capacity:30 Minutes,

Memory:Write Speed:Several MB/s to over 100 MB/s,

Memory:Windows Directory:C\:\\camera\\defaults,

Camera Settings:Metering Methods:average\,multi-zone\,partial\,spot,

Camera Settings:Exposure Control:Auto\, Manual\, Program\, Shutter Priority,

Camera Settings:Crop Mode:APS-C,

:What's in the box?:Camera Body\,Lens\,Battery pack\,Manual,

:Warranty:1 year manufacturer,

:Best Sellers Rank:#1\,065 in Electronics\,#1 in DSLR Cameras

3

 

Alternatively, you can also create multiple separate columns, each containing one or more values. For example, to have one column for each section, you can submit this in 4 cells as follows:

 

N

O

P

Q

1

product_detail

product_detail

product_detail

product_detail

2

Connectivity:Connectivity Technology:HDMI\, NFC\, USB,

Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC,

Connectivity:Video Output:Type C Mini HDMI,

Connectivity:Total Video Out Ports:2

Memory:Flash Memory Type:Single Slot\: SD/SDHC/SDXC (UHS-I),

Memory:Recording Capacity:30 Minutes,

Memory:Write Speed:Several MB/s to over 100 MB/s,

Memory:Windows Directory:C\:\\camera\\defaults

Camera Settings:Metering Methods:average\,multi-zone\,partial\,spot,

Camera Settings:Exposure Control:Auto\, Manual\, Program\, Shutter Priority,

Camera Settings:Crop Mode:APS-C

:What's in the box?:Camera Body\,Lens\,Battery pack\,Manual,

:Warranty:1 year manufacturer,

:Best Sellers Rank:#1\,065 in Electronics\,#1 in DSLR Cameras

3

Lastly, you can submit each value in its individual cell, in which case you would need 14 columns as follows (only 3 columns shown):

 

N

O

P

Q

1

product_detail

product_detail

product_detail

2

Connectivity:Connectivity Technology:HDMI\, NFC\, USB

Connectivity:Wireless Technology:BuiltIn 802.11b/g/n with NFC

Connectivity:Video Output:Type C Mini HDMI

3

 

 

 

 

Was this helpful?

How can we improve it?
false
Search
Clear search
Close search
Main menu
6368033068213058156
true
Search Help Center
false
true
true
true
true
true
71525
false
false
true
false