Notification

In this help center, 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 you're using the article for the Merchant Center version that applies to you. 

Shipping length [shipping_length], shipping width [shipping_width], shipping 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 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.

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

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

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 weight

To 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

Was this helpful?

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