Enter the dimensions of the package for your product using the shipping length [shipping_length]
, shipping width [shipping_width]
, and shipping height [shipping_height]
attributes. These 3 attributes help determine the shipping cost if you’re using a carrier-calculated shipping method in Merchant Center.
In this article
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_length]
, shipping width [shipping_width]
, and shipping height [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".
Format
Follow these formatting guidelines to make sure Google understands the data 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 |
Shipping length formatting
File format | Example entry |
---|---|
Text (TSV) | 20 in |
XML (Feeds) | <g:shipping_length>20 in</g:shipping_length> |
Shipping width formatting
File format | Example entry |
---|---|
Text (TSV) | 40 in |
XML (Feeds) | <g:shipping_width>40 in</g:shipping_width> |
Shipping height formatting
File format | Example entry |
---|---|
Text (TSV) | 10 in |
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 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 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
[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
Shipping costs based on dimensions and weightTo see accurate shipping costs in your ads and free product listings, submit all dimension attributes and shipping weight [shipping_weight]
. For example:
Product data for an XXL Orthopedic Dog Bed | |
Attribute | Value |
Title [title] |
XXL Orthopedic Dog Bed |
Shipping length [shipping_length] |
54 in |
Shipping width [shipping_width] |
64 in |
Shipping height [shipping_height] |
10 in |
Shipping weight [shipping_weight] |
13 lbs |
Product data for a 10-ft Ocean Kayak | |
Attribute | Value |
Title [title] |
10-ft Ocean Kayak |
Shipping length [shipping_length] |
120 in |
Shipping width [shipping_width] |
30 in |
Shipping height [shipping_height] |
15 in |
Shipping weight [shipping_weight] |
45 lbs |
Product data for a 4” Pool Noodle, 6 Pack | |
Attribute | Value |
Title [title] |
Pool Noodle - 4" - 6 Pack |
Shipping length [shipping_length] |
48 in |
Shipping width [shipping_width] |
4 in |
Shipping height [shipping_height] |
4 in |
Shipping weight [shipping_weight] |
5 lbs |
Product data for a 6-ft Fishing Rod | |
Attribute | Value |
Title [title] |
6-ft Medium-Heavy Fishing Rod, 1-Piece |
Shipping length [shipping_length] |
74 in |
Shipping width [shipping_width] |
6 in |
Shipping height [shipping_height] |
7 in |
Shipping weight [shipping_weight] |
8 oz |