shipping_length, shipping_width, shipping_height: Definition

 

Enter the dimensions of the package for your product using the 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	<g:shipping_length>20 in</g:shipping_length>

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	<g:shipping_width>40 in</g:shipping_width>

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	<g:shipping_height>10 in</g:shipping_height>

To format your data for Content API, see the Content API for Shopping.

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 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

Shipping costs based on dimensions and weight

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