shipping_length [delivery_length], shipping_width [delivery_width], shipping_height [delivery_height]: Definition

Enter the dimensions of the package for your product using the shipping_length [delivery_length], shipping_width [delivery_width] and shipping_height [delivery_height] attributes. These 3 attributes help to determine the delivery cost if you’re using a carrier-calculated delivery 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 delivery rates, provide them using the shipping_length [delivery_length], shipping_width [delivery_width] and shipping_height [delivery_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. Find out more about carrier-calculated delivery.

Format

Follow these formatting guidelines to make sure that we understand the data that 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 [delivery_length] formatting

File format Example entry
Text feeds 20 in
XML feeds

<g:shipping_length>20 in</g:shipping_length>


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

shipping_width [delivery_width] formatting

File format Example entry
Text feeds 40 in
XML feeds

<g:shipping_width>40 in</g:shipping_width>


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

shipping_height [delivery_height] formatting

File format Example entry
Text feeds 10 in
XML feeds

<g:shipping_height>10 in</g:shipping_height>


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

Guidelines

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

Minimum requirements

These are the requirements that 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 on 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 delivery cost.
  • Use the same unit of measurement for each attribute. Otherwise, the information can’t be used to calculate the delivery cost.

Best practices

These are best practices that can help you go beyond the basic requirements to optimise your product data for performance. 

  • Use dimension attributes along with the shipping_weight [delivery_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 weight

To see accurate delivery costs in your ads, submit all dimension attributes and shipping_weight [shipping_weight]. For example:

Product Orthopaedic dog bed
title [title] XXL Orthopaedic Dog Bed
shipping_length [delivery_length] 137 cm
shipping_width [delivery_width] 163 cm
shipping_height [delivery_height] 25 cm
shipping_weight [delivery_weight] 6 kg
 
Product Kayak
title [title] 3-metre ocean kayak
shipping_length [delivery_length] 305 cm
shipping_width [delivery_width] 76 cm
shipping_height [delivery_height] 38 cm
shipping_weight [delivery_weight] 20 kg
 
Product Foam pool noodle 6 pack
title [title] Pool Noodle - 10 cm - 6 Pack
shipping_length [delivery_length] 122 cm
shipping_width [delivery_width] 10 cm
shipping_height [delivery_height] 10 cm
shipping_weight [delivery_weight] 2.25 kg
 
Product Fishing rod
title [title] 6-ft Medium-Heavy Fishing Rod, 1-Piece
shipping_length [delivery_length] 188 cm
shipping_width [delivery_width] 15 cm
shipping_height [delivery_height] 18 cm
shipping_weight [delivery_weight] 225 g
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue