Use the product length [product_length]
, product width [product_width]
, product height [product_height]
and product weight [product_weight]
attributes to clearly communicate the measurements of the product that you're selling. These attributes can help customers to find you and your products by improving the accuracy of search results.
In this article
When to use
Optional for each product
You can specify the dimensions and weight of the product by using the product length [product_length],
product width [product_width]
, product height [product_height]
and product weight [product_weight]
attributes. If you want to specify dimensions or weight for carrier-calculated delivery rates, use the delivery length [shipping_length]
, delivery width [shipping_width]
and delivery height [shipping_height]
attributes or the shipping weight [shipping_weight]
attribute.
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 | Number plus measurement unit |
Supported units |
|
Limits |
|
Repeated field | No |
Schema.org property |
Type: Note that schema.org property |
File format | Example entry |
Text feeds | 20 in. |
XML feeds | <g:product_length>20 in.</g:product_length> |
To format your data for Content API, see the Content API for Shopping resource.
Best practices
These best practices can help you to go beyond the basic requirements to optimise your product data for performance.
- Include as many of these product measurement attributes as possible.
- Use the same unit of measurement for each product dimension attribute (including product length, width and height). Otherwise, the information won't be displayed.
- Use the actual assembled product weight for the product weight attribute. If your product comes in multiple pieces, for example, as part of a bundle, use the complete weight of all of the pieces in the listing.
If you specified dimensions or weight in the product detail [product_detail]
attribute as well, make sure that they use the same values and units.