Enter the dimensions of the package for your product using the delivery length [shipping_length], delivery width [shipping_width] and delivery height [shipping_height] attributes. These three attributes help determine the delivery cost if you're using a carrier-calculated delivery method in Merchant Center.
In this article
When to use
Optional for each product
If you want to specify dimensions for carrier-calculated delivery rates, provide them using the delivery length [shipping_length], delivery width [shipping_width] and delivery height [shipping_height] attributes. You can set up carrier-calculated delivery in your Merchant Center account delivery settings.
Delivery costs are calculated based on dimensions and weight, so providing the dimensions of your package will help ensure that Google calculates the cost correctly. Dimensions and weight are especially important for unusually shaped products such as 'pool noodles' or 'fishing rods'.
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 dimension unit |
|---|---|
| Supported units | cm, inch |
| Limits | 1–400 for cm, 1–150 for inch |
| Repeated field | No |
Delivery length formatting
| File format | Example entry |
|---|---|
| Text (TSV) | 51 cm |
| XML (Feeds) | <g:shipping_length>20 in</g:shipping_length> |
Delivery width formatting
| File format | Example entry |
|---|---|
| Text (TSV) | 102 cm |
| XML (Feeds) | <g:shipping_width>40 in</g:shipping_width> |
Delivery height formatting
| File format | Example entry |
|---|---|
| Text (TSV) | 25 cm |
| XML (Feeds) | <g:shipping_height>10 in</g:shipping_height> |
To format your data for Content API, see the Content API for Shopping resource.
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.
- Include all dimension attributes if you include any of them. If you don't include all of the attributes, the information can't be used to calculate delivery cost.
- Use the same unit of measurement for each attribute. Otherwise, the information can't be used to calculate delivery cost.
Best practices
These best practices can help you to go beyond the basic requirements to optimise your product data for performance.
- Use dimension attributes along with the delivery weight
[shipping_weight]attribute. Carrier-calculated delivery rates can vary depending on the weight and dimensions of your product. So if you don't provide both dimensions and weight, the calculated delivery cost might not be accurate.
Examples
Delivery costs based on dimensions and weightTo see accurate delivery costs in your ads and free product listings, submit all dimension attributes and delivery weight [shipping_weight]. For example:
| Product data for an XXL orthopaedic dog bed | |
| Attribute | Value |
Title [title] |
XXL orthopaedic dog bed |
Delivery length [shipping_length] |
137 cm |
Delivery width [shipping_width] |
163 cm |
Delivery height [shipping_height] |
25 cm |
Delivery weight [shipping_weight] |
6 kg |
| Product data for a 3 metre ocean kayak | |
| Attribute | Value |
Title [title] |
3 metre ocean kayak |
Delivery length [shipping_length] |
305 cm |
Delivery width [shipping_width] |
76 cm |
Delivery height [shipping_height] |
38 cm |
Delivery weight [shipping_weight] |
20 kg |
| Product data for a 10 cm pool noodle, 6 pack | |
| Attribute | Value |
Title [title] |
Pool noodle – 10 cm – 6 pack |
Delivery length [shipping_length] |
122 cm |
Delivery width [shipping_width] |
10 cm |
Delivery height [shipping_height] |
10 cm |
Delivery weight [shipping_weight] |
2.25 kg |
| Product data for a 183 cm fishing rod | |
| Attribute | Value |
Title [title] |
183 cm Medium-Heavy Fishing Rod, 1-Piece |
Delivery length [shipping_length] |
188 cm |
Delivery width [shipping_width] |
15 cm |
Delivery height [shipping_height] |
18 cm |
Delivery weight [shipping_weight] |
225 g |