In this Help Centre, you can find content for both Merchant Center Next and the classic Merchant Center experience. Look for the logo at the top of each article to make sure that you're using the article for the Merchant Center version that applies to you. 

Delivery length [shipping_length], delivery width [shipping_width], delivery height [shipping_height]

A custom icon for Merchant Center Classic and Merchant Center Next.

Enter the dimensions of the package for your product using the delivery length [shipping_length], delivery width [shipping_width] and delivery height [shipping_height] attributes. These three attributes help 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

In this article

When to use

Optional Optional for each product

If you want to specify dimensions for carrier-calculated delivery rates, provide them using the delivery length [shipping_length], delivery width [shipping_width] and delivery height [shipping_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'.


Follow these formatting guidelines to make sure that Google understands the data that 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

Delivery length formatting

File format Example entry
Text (TSV) 51 cm
XML (Feeds) <g:shipping_length>20 in</g:shipping_length>

Delivery width formatting

File format Example entry
Text (TSV) 102 cm
XML (Feeds) <g:shipping_width>40 in</g:shipping_width>

Delivery height formatting

File format Example entry
Text (TSV) 25 cm
XML (Feeds) <g:shipping_height>10 in</g:shipping_height>

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

Note: To ensure that this product data attribute is recognised by our system correctly, remember to submit your data feed file in a format that we support.

Minimum requirements

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

Best practices

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

  • Use dimension attributes along with the delivery weight [shipping_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.


Delivery costs based on dimensions and weight

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

Product data for an XXL orthopaedic dog bed
Attribute Value
Title [title] XXL orthopaedic dog bed
Delivery length [shipping_length] 137 cm
Delivery width [shipping_width] 163 cm
Delivery height [shipping_height] 25 cm
Delivery weight [shipping_weight] 6 kg
Product data for a 3 metre ocean kayak
Attribute Value
Title [title] 3 metre ocean kayak
Delivery length [shipping_length] 305 cm
Delivery width [shipping_width] 76 cm
Delivery height [shipping_height] 38 cm
Delivery weight [shipping_weight] 20 kg


Product data for a 10 cm pool noodle, 6 pack
Attribute Value
Title [title] Pool noodle – 10 cm – 6 pack
Delivery length [shipping_length] 122 cm
Delivery width [shipping_width] 10 cm
Delivery height [shipping_height] 10 cm
Delivery weight [shipping_weight] 2.25 kg


Product data for a 183 cm fishing rod
Attribute Value
Title [title] 183 cm Medium-Heavy Fishing Rod, 1-Piece
Delivery length [shipping_length] 188 cm
Delivery width [shipping_width] 15 cm
Delivery height [shipping_height] 18 cm
Delivery weight [shipping_weight] 225 g

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Centre