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> |
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 the Diagnostics page in your Merchant Center account.
- Each
product_detail
has 3 sub-attributes. They aresection_name
,attribute_name
, andattribute_value
.section_name
is optional but recommended.attribute_name
andattribute_value
are always required for eachproduct_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]
- If there is no section name then the correct format is to start with a ":". As in the example below
- Each
- 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
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. - Don't list keywords or search terms. Only list relevant details and specifications of the product.
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
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
Running Shoes
- product detail:
- section name: Sustainability
- attribute name: Material, attribute value: Recycled
- section name: Sustainability
Jacket
- product detail:
- section name: Sustainability
- attribute name: Material, attribute value: Organic
- section name: Sustainability
Appliances
Clothes Dryer
- product detail:
- section name: Sustainability
- attribute name: Certification, attribute value: Energy Star
- section name: Sustainability
Mobile Phones
- 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
- Body features
- Sensor
- Processor
- Video
- Lens System
- Focal length
- Aperture range
- Note: Use the “Lens System” section 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: Body Features
- attribute name: Sensor, attribute value: CMOS
- attribute name: Processor, attribute value: ABCD Image Processor
- attribute name: Video, attribute value: 1080p full HD 60 fps
- section name: Body Features
- Product 2 - Camera bundle with body and 50mm - F/1.8 lens
- id: camera1-bundle-A
- item group id: camera1
- product detail:
- section name: Body Features
- attribute name: Sensor, attribute value: CMOS
- attribute name: Processor, attribute value: ABCD Image Processor
- attribute name: Video, attribute value: 1080p full HD 60 fps
- section name: Lens System
- attribute name: Focal length, attribute value:
50mm
- attribute name: Aperture range, attribute value: F/1.8
- attribute name: Focal length, attribute value:
- section name: Body Features
- Product 3 - Camera bundle with body and 24-105mm - F/4.0 lens
- id: camera1-bundle-B
- item group id: camera1
- product detail:
- section name: Body Features
- attribute name: Sensor, attribute value: CMOS
- attribute name: Processor, attribute value: ABCD Image Processor
- attribute name: Video, attribute value: 1080p full HD 60 fps
- Lens System
- attribute name: Focal length, attribute value:
24-105mm
- attribute name: Aperture range, attribute value:
F/4.0
- attribute name: Focal length, attribute value:
- section name: Body Features
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