product detail [product_detail]

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

When to use

Optional for all products.

Format

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

Type String (Unicode characters. Recommended: ASCII only)
Limits Section name: up to 140 characters recommended 
Attribute name: up to140 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>

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 upload this attribute for your product. If you don't follow these requirements, we'll disapprove this attribute and let you know in the Key Actions page of your Manufacturer Center account. 

  • Each product detail [product_detail] has 3 required sub-attributes. They are section name [section_name], attribute name [attribute_name], and attribute value [attribute_value].
    • You must include all 3 for each product detail [product_detail] you submit.
  • When submitting TSV files, 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].

    • 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 include promotional 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 [section_name] and attribute name [attribute_name] combinations you might include for different types of products. Please 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

  • 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

  • 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 article helpful?
How can we improve it?