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.

An illustration of a box showing shipping dimensions like height, length, and width

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>

For format API information, 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>

For format API information, 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>

For format API information, see the Content API for Shopping.

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of 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 are best practices that 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, 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 bs

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
Was this helpful?
How can we improve it?