Use the shipping label [shipping_label] attribute to group products together so that you can set up 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".
On this page
When to use
Optional for each product
If you want to set different shipping costs or speed 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 to those products with a label.
You can configure shipping costs and speed based on the label in your Merchant Center account settings using shipping labels.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting. Learn when and how to submit your product data.
| Formatting specifications | |
|---|---|
| Technical name | shipping_label |
| Type | Unicode characters (Recommended: ASCII only) |
| Repeated field | No |
File format examples
To ensure your attribute is recognized correctly, use the formatting specific to your data source type.
| Data source format | Examples |
|---|---|
| Text (TSV or CSV) data sources | Oversized |
| XML data sources | <g:shipping_label>oversized</g:shipping_label> |
| Merchant API | To format your data for Merchant API, check the Merchant API resource. |
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.
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 (for example, 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.
- Use a shipping label for perishable products (for example, cold storage transport) and configure shipping settings in Merchant Center.
- 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've 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.
Examples
| 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 |
| 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 |