shipping_length
, shipping_width
, and shipping_height
attributes. These 3 attributes help determine the shipping cost if you’re using a carrier-calculated shipping method in Merchant Center.
When to use
Optional for each product
If you want to specify dimensions for carrier-calculated shipping rates, provide them using the shipping_length
, shipping_width
, and shipping_height
attributes. You can set up carrier-calculated shipping in your Merchant Center account shipping settings.
Shipping 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. Learn more about carrier-calculated shipping.
Format
Follow these formatting guidelines to make sure we understand the data you're submitting.
Type | Number plus dimension unit |
---|---|
Supported units | cm , inch |
Limits | 1 - 400 for cm, 1 - 150 for inch |
Repeated field | No |
shipping_length formatting
File format | Example entry |
---|---|
Text feeds | 20 in |
XML feeds |
|
To format your data for Content API, see the Content API for Shopping.
shipping_width formatting
File format | Example entry |
---|---|
Text feeds | 40 in |
XML feeds |
|
To format your data for Content API, see the Content API for Shopping.
shipping_height formatting
File format | Example entry |
---|---|
Text feeds | 10 in |
XML feeds |
|
To format your data for Content API, see the Content API for Shopping.
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.
- 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 shipping cost.
- Use the same unit of measurement for each attribute. Otherwise, the information can’t be used to calculate shipping cost.
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Use dimension attributes along with the
shipping_weight
attribute. Carrier-calculated shipping rates can vary depending on the weight and dimensions of your product. So if you don’t provide both dimensions and weight, the calculated shipping cost might not be accurate.
Examples
To see accurate shipping costs in your ads and free product listings, submit all dimension attributes and shipping_weight
. For example:
Product | Orthopedic dog bed |
title |
XXL Orthopedic Dog Bed |
shipping_length |
54 in |
shipping_width |
64 in |
shipping_height |
10 in |
shipping_weight |
13 lbs |
Product | Kayak |
title |
10-ft Ocean Kayak |
shipping_length |
120 in |
shipping_width |
30 in |
shipping_height |
15 in |
shipping_weight |
45 lbs |
Product | Foam pool noodle 6 pack |
title |
Pool Noodle - 4" - 6 Pack |
shipping_length |
48 in |
shipping_width |
4 in |
shipping_height |
4 in |
shipping_weight |
5 lbs |
Product | Fishing rod |
title |
6-ft Medium-Heavy Fishing Rod, 1-Piece |
shipping_length |
74 in |
shipping_width |
6 in |
shipping_height |
7 in |
shipping_weight |
8 oz |