Shipping label [shipping_label]

Use the shipping label [shipping_label] attribute to group products together so that you can configure specific shipping rates in Merchant Center. The information you include in this attribute won’t be shown to customers.

For example, you might label products "oversized", "perishable", or "free shipping".

How shipping cost could be displayed in your ad

When to use

Optional for each product

If you want to set different shipping costs for specific groups of products, use the shipping label [shipping_label] attribute to apply a label to products. For example, for free shipping, some retailers only want certain products to get free shipping and they can add that shipping service (without removing any of the other services) to those products with a label.

You can configure shipping costs based on the label in your Merchant Center account settings using shipping groups. Learn more about shipping settings

Note: When you add a label to a product, it’ll allow that service while also enabling all of the other services, such as US shipping, weight-based, and standard, that are available for that product. Shipping labels are additive or inclusive, meaning that adding a label to a product will allow that product to be shipped with that service while still allowing for all the other services.


Follow these formatting guidelines to make sure Google understands the data you're submitting.

For details on when and how to submit values in English, learn more about submitting your product data

Type Unicode characters (Recommended: ASCII only)
Repeated field No
File format Example entry


XML feeds <g:shipping_label>oversized</g:shipping_label>
To format your data for Content API, see the Content API for Shopping.


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.

  • Don't submit invalid unicode characters. These characters are generally added during your file's encoding process. To avoid them, use UTF-8 encoding. To help prevent encoding issues, submit files in a compressed format. Examples of invalid unicode characters include:
    • Control characters (e.g., U+200D)
    • Function characters
    • Private area characters
    • Surrogate pairs
    • Unassigned code points

Best practices

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

  • Choose your own definition for the shipping label. You can choose values that make it easier for you to configure your shipping settings in Merchant Center.
  • Use a shipping label for oversized products and configure shipping settings in Merchant Center if your product is considered oversized by your shipping carrier. Oversized shipping costs aren’t automatically calculated and automatic carrier rates shouldn’t be used in this case. Learn more about shipping settings
  • Use a shipping label for perishable products (for example, cold storage transport) and configure shipping settings in Merchant Center. Learn more about shipping settings
  • Note that shipping labels are inclusive. If you provide multiple shipping labels for a product in the same country, we’ll calculate the lowest shipping rate for the product for a given situation and display that rate to users. For example, if you have one label that specifies free shipping for products over 150 USD and another label that specifies a carrier-calculated rate for all products, then your listing will show free shipping for all products over 150 USD.


Perishable products

beverage container with a MPN tag

Product data for one gallon of whole milk
Attribute Value
Title [title] Whole Milk, 1 Gal
Shipping label [shipping_label] Perishable
Shipping length [shipping_length] 6 in
Shipping width [shipping_width] 6 in
Shipping height [shipping_height] 11 in
Shipping weight [shipping_weight] 8.8 lbs
Oversized products
Product data for a 10-foot ocean kayak
Attribute Value
Title [title] 10-ft Ocean Kayak
Shipping label [shipping_label] Oversized
Shipping length [shipping_length] 120 in
Shipping width [shipping_width] 30 in
Shipping height [shipping_height] 15 in
Shipping weight [shipping_weight] 45 lbs
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center