The carrier shipping [carrier_shipping]
attribute lets you provide shipping speed and cost for a product based on a carrier service. Shipping cost and speed will be calculated based on the origin location and the customer’s location.
Use this attribute when the account shipping settings for your product are not defined in Merchant Center or when you need to override the shipping settings that you set up in Merchant Center. You need to submit shipping weight [shipping_weight]
and preferably add shipping dimensions to use carrier based shipping cost.
In this article
When to use
Optional
Carrier cost and speeds provide more accurate shipping cost and speed for customers as their location is used to determine the shipping cost and transit time. Instead of providing cost and transit time directly, you can provide the carrier service you use and where you deliver from. For example, “I ship with US Mail carrier service from my warehouse in 94043”.
Sub-attributes
The carrier shipping [carrier_shipping]
attribute uses sub-attributes to define country, delivery area, service, price, handling time, and transit time.
These are the various sub-attributes:
- Country
[country]
(Required)
The country that the product can be delivered to. Submit an ISO 3166-1 country code (for example: CH). - Delivery area (Optional)
To specify where your product can be delivered, submit one (and only one) of the following:- Region
[region]
(Optional)
Submit a region, state, territory, or prefecture. This is supported for Australia, Brazil, France, Germany, India, Japan, New Zealand, and the United States. Submit a subdivision code from the ISO 3166-2 code tables (AU, BR, FR DE, IN, JP, NZ, US) without country prefix (for example, NSW, RJ, ARA, BE, AP, 03, AUK, NY). - Postal code
[postal_code]
(Optional)
Submit a postal code range. This is supported for Australia, Brazil, Canada, France, Germany, India, New Zealand, and the United States.- Use a ZIP or postal code (for example, 94043 for US and 2009 for Australia).
- Use a range of postal codes (for example, 94002-95460 for US and 2009-3000 Australia).
- Use a range of postal codes using a prefix with a wildcard ( * ) (for example, 94*).
- Use a range of postal codes using 2 prefixes with wildcards ( * ) (for example, 94*-95*).
- Region
- Origin Postal code
[origin_postal_code]
(Required)
The Origin Postal code[origin_postal_code]
is the domestic ZIP or postal code of the country that’s added in the Country[country]
sub-attribute and from where the order is being shipped. For example, 94043 for US and 2009 for Australia.
The United Kingdom
- Shipping price (Required to provide shipping speed overrides, otherwise optional)
To specify shipping cost, submit one (and only one) of the following:- Manual Price
[flat_price]
-
Submit a fixed shipping cost, and use a period [.] as the decimal separator (for example: 3.00 USD). Avoid commas [,] to ensure that the price is interpreted correctly.
-
-
Carrier price
[carrier_price]
-
Indicate which carrier service the price should be derived from. In the table below, identify the carrier service, and input the Enumeration Value into the sub-attribute (view examples below).
-
- Manual Price
[flat_price]
or carrier price [carrier_price]
sub-attributes of the carrier shipping [carrier_shipping]
attribute, the account shipping service settings (including shipping service delivery times and minimum order value) will be ignored for the matching location for that product.- Carrier price adjustment (Optional)
To indicate that the applied carrier rate should have a modification on them. This can be used for a discount or additional fees. Submit one (and only one) of the following:- Flat price adjustment
[carrier_price_flat_adjustment]
- Submit a fixed shipping cost, and use a period [.] as the decimal separator. For example: 3.00 USD. Avoid commas [,] to ensure that the price is interpreted correctly.
- Percentage price adjustment
[carrier_price_percentage_adjustment]
- Submit either a positive or negative number that represents a percentage, for example, -25 for 25% off.
- Flat price adjustment
- Handling time (Optional)
To specify how long a product may spend in handling submit the following sub-attributes:- Minimum handling time
[min_handling_time]
This is the minimum number of days between when an order is placed and when it's handed off to a shipping carrier. - Maximum handling time
[max_handling_time]
This is the maximum number of days between when an order is placed and when it's handed off to a shipping carrier.
- Minimum handling time
You may also use the standalone handling time attributes instead of the shipping handling time sub-attributes. If both are present then the shipping sub-attributes will be used.
Refrain from using both the carrier shipping [carrier_shipping]
sub-attributes for handling time and the standalone attributes for handling time. If both sets of attributes are provided for a product, the carrier shipping sub-attributes will override standalone handling time attributes.
Use business days. For example, if a customer orders on Tuesday and the shipment leaves the warehouse on Friday at the latest, the maximum handling time is 3 days.
- Transit time (Optional)
To specify how long a product may spend in transit, submit one of the following options. Note that when the minimum and maximum transit time and carrier transit time are provided, carrier shipping will use the carrier transit time:- Manual transit time
For a defined transit time, submit the following sub-attributes:- Minimum transit time
[fixed_min_transit_time]
This is the minimum number of days between when a product is handed off to a shipping carrier and when it's delivered to the customer. - Maximum transit time
[fixed_max_transit_time]
This is the maximum number of days between when a product is handed off to a shipping carrier and when it's delivered to the customer.
- Minimum transit time
- Carrier transit time
[carrier_transit_time]
To indicate transit time based on the carrier handling the delivery, in the table below, identify the carrier service, and input the Enumeration Value into the sub-attribute (view examples below). When selecting this option, the transit time will take into consideration both the shipping location specified in[origin_postal_code]
, as well as the user's destination when looking at the offer or product.
- Manual transit time
- Values for the maximum handling time
[max_handling_time]
, either the sub-attribute of carrier shipping[carrier_shipping]
or the standalone attribute. - The transit time, either manually with the fixed max transit time
[fixed_max_transit_time]
sub-attribute or selecting a carrier in the carrier transit time[carrier_transit_time]
sub-attribute of the carrier shipping[carrier_shipping]
attribute. - A value for the price, either by manually inputting flat price
[flat_price]
or selecting carrier in the carrier price[carrier_price]
sub-attribute of the carrier shipping[carrier_shipping]
attribute.
These are required for the handling time and transit time to be considered valid. Multiple carriers and different shipping locations will require multiple shipping attributes.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting.
Type | Unicode characters (Recommended: ASCII only) |
Repeated field (What’s this?) |
Submit the shipping You can submit up to 100 |
File format | Example entry |
---|---|
Text feeds |
Format the name by including which sub-attributes you’re submitting. Include carrier shipping Name If you name the sub-attributes you're using, you can give them to us in any order. However, if you provide sub-attribute values but do not name them, we’ll assume that your attribute values include sub-attributes in this order:
Format the value by submitting the value of each sub-attribute listed in the same order as in the name and separated with a colon ( : ). Don’t use quotation marks. For example: Name To submit multiple locations, submit the attribute (with the same name) multiple times. For example: Name Name If you don’t want to provide an optional sub-attribute for a particular product, then still add a colon ( : ), but leave the text blank. For example: Name Name |
XML feeds |
Include the optional sub-attributes if you need them. To specify a shipping cost for different delivery locations, submit the carrier shipping
|
An example of using a carrier for both price and transit time.
File format | Example entry |
---|---|
Text (TSV) |
Name |
XML (Feeds) |
|
An example of using a carrier for transit time with manual shipping price.
File format | Example entry |
---|---|
Text (TSV) |
Name |
XML (Feeds) |
|
An example of manual transit time with carrier-based shipping price.
File format | Example entry |
---|---|
Text (TSV) |
Name |
XML (Feeds) |
|
To format your data for Content API, check the Content API for Shopping resource.
Supported carrier services
Australia
* Carrier-based shipping speed is not yet supported in Australia.
Australia Post | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Regular Parcel | AUSTRALIA_POST_REGULAR |
||
Express Post | AUSTRALIA_POST_EXPRESS |
||
Regular Parcel S | AUSTRALIA_POST_REGULAR_S |
||
Regular Parcel M | AUSTRALIA_POST_REGULAR_M |
||
Regular Parcel L | AUSTRALIA_POST_REGULAR_L |
||
Regular Parcel XL | AUSTRALIA_POST_REGULAR_XL |
||
Express Post S | AUSTRALIA_POST_EXPRESS_S |
||
Express Post M | AUSTRALIA_POST_EXPRESS_M |
||
Express Post L | AUSTRALIA_POST_EXPRESS_L |
||
Express Post XL | AUSTRALIA_POST_EXPRESS_XL |
||
TNT | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Road Express | TNT_ROAD_EXPRESS |
||
Overnight Express | TNT_OVERNIGHT_EXPRESS |
||
Toll | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Road Delivery | TOLL_ROAD_DELIVERY |
||
Overnight Priority | TOLL_OVERNIGHT_PRIORITY |
France
* Carrier-based shipping cost is not yet supported in France.
Colissimo | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Domicile | COLISSIMO_DOMICILE |
||
DHL | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express 12am | DHL_EXPRESS_12AM |
||
Express 9am | DHL_EXPRESS_9AM |
||
Geodis | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express Shipping | GEODIS_EXPRESS |
||
Pack 30 | GEODIS_PACK_30 |
||
Same-Day Solutions | GEODIS_SAME_DAY |
||
Top 24 | GEODIS_TOP_24 |
||
TNT | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Essentiel 24h | TNT_ESSENTIEL_24H |
||
Essentiel flexibilité | TNT_ESSENTIEL_FLEXIBILITE |
Germany
DHL | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Paket | DHL_PAKET |
||
Päckchen | DHL_PACKCHEN |
||
ExpressEasy | DHL_EXPRESSEASY |
||
DPD | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express 12 | DPD_EXPRESS_12 |
||
Express | DPD_EXPRESS |
||
Classic Parcel | DPD_CLASSIC_PARCEL |
||
Hermes | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Päckchen | HERMES_PACKCHEN |
||
Paketklasse S | HERMES_PAKETKLASSE_S |
||
Paketklasse M | HERMES_PAKETKLASSE_M |
||
Paketklasse L | HERMES_PAKETKLASSE_L |
||
Haustür-Zustellung | HERMES_HAUSTUR |
||
PaketShop-Zustellung | HERMES_PAKETSHOP |
||
UPS | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express | UPS_EXPRESS |
||
Express Saver | UPS_EXPRESS_SAVER |
||
Express Standard | UPS_EXPRESS_STANDARD |
||
GLS | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Business Parcel | GLS_BUSINESS |
||
Express Parcel | GLS_EXPRESS |
||
Private National | GLS_PRIVATE |
United Kingdom
DHL | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express | DHL_EXPRESS |
||
Express 12 | DHL_EXPRESS_12 |
||
DPD | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express 12 | DPD_EXPRESS_12 |
||
Express Next Day | DPD_NEXT_DAY |
||
Standard Parcel Next Day | DPD_STANDARD_NEXT_DAY |
||
Standard Parcel Two Day | DPD_STANDARD_TWO_DAY |
||
RMG | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
1st Class Small Parcel | RMG_1ST_CLASS_SMALL |
||
1st Class Medium Parcel | RMG_1ST_CLASS_MEDIUM |
||
2nd Class Small Parcel | RMG_2ND_CLASS_SMALL |
||
2nd Class Medium Parcel | RMG_2ND_CLASS_MEDIUM |
||
TNT | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express | TNT_EXPRESS |
||
Express 10 | TNT_EXPRESS_10 |
||
Express 12 | TNT_EXPRESS_12 |
||
UPS | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Express | UPS_EXPRESS |
||
Express Saver | UPS_EXPRESS_SAVER |
||
Standard | UPS_STANDARD |
||
Yodel | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
B2C 48HR | YODEL_B2C_48HR |
||
B2C 72HR | YODEL_B2C_72HR |
||
B2C Packet | YODEL_B2C_PACKET |
United States
FedEx | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Ground | FEDEX_GROUND |
||
Home Delivery | FEDEX_HOME_DELIVERY |
||
Express Saver | FEDEX_EXPRESS_SAVER |
||
First Overnight | FEDEX_FIRST_OVERNIGHT |
||
Priority Overnight | FEDEX_PRIORITY_OVERNIGHT |
||
Standard Overnight | FEDEX_STANDARD_OVERNIGHT |
||
2Day | FEDEX_2DAY |
||
UPS | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
2nd Day Air | UPS_2ND_DAY_AIR |
||
2nd Day Air AM | UPS_2ND_DAY_AM |
||
3 Day Select | UPS_3_DAY_SELECT |
||
Ground | UPS_GROUND |
||
Next Day Air | UPS_NEXT_DAY_AIR |
||
Next Day Air Early AM | UPS_NEXT_DAY_AIR_EARLY_AM |
||
Next Day Air Saver | UPS_NEXT_DAY_AIR_SAVER |
||
USPS | |||
Carrier service | Enumeration value | Shipping cost | Shipping speed |
Priority Mail Express | USPS_PRIORITY_MAIL_EXPRESS |
||
Media Mail | USPS_MEDIA_MAIL |
||
Ground Advantage Retail | USPS_GROUND_ADVANTAGE_RETAIL |
||
Priority Mail | USPS_PRIORITY_MAIL |
||
Ground Advantage Commercial | USPS_GROUND_ADVANTAGE_COMMERCIAL |
||
First Class Mail | USPS_FIRST_CLASS_MAIL |
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.
- Submit complete and correct shipping information, including speed and costs.
- To properly use carrier-based shipping cost it is also required to include the following attributes:
- shipping weight
[shipping_weight]
- shipping length
[shipping_length]
- shipping width
[shipping_width]
- shipping height
[shipping_height]
- shipping weight
- Shipping speed and cost are 2 of the most common reasons why shoppers abandon a product, so be sure that your shipping settings are accurate and up to date to make your ads and listings effective.
- Include all relevant shipping charges. Include all charges for a purchase that include the words "shipping", "delivery", "handling", "logistics", or "carrier".
- Overestimate if you can’t provide an accurate shipping cost. Match or overestimate the cost users would pay.Note that overestimating excessively may negatively impact your product performance.
- Use the rate for shipping directly to an individual. Don’t use other rates such as the rate for shipping to a store or a rate that requires a membership to be applicable.
- Display product details on your landing page to all users. Ensure when a user clicks your ad, can view details about your product, even if you don’t ship to the user’s location.
- Comply with local laws when submitting shipping information.
- Provide the country sub-attribute. Always provide the country
[country]
sub-attribute of the carrier shipping[carrier_shipping]
attribute to ensure your products ship correctly.
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Use account shipping settings in Merchant Center. With these settings you can create simple flat rates or complex, custom models. Use the carrier shipping
[carrier_shipping]
attribute as a last resort to override the settings you create in Merchant Center. - When selecting a carrier for shipping price, ensure the selected carrier is correctly written as the enumeration value listed.
- When submitting a shipping price manually, ensure that it can be represented in your target country's currency (according to ISO 4217). For example, instead of 1.0012 USD, submit 1.01 USD. If your price can’t be represented in your target country's currency, then we’ll round it to a value that can.
- When selecting a carrier for shipping transit time, ensure the selected carrier is correctly written as the enumeration value listed.
- Use the shipping handling business days
[shipping_handling_business_days]
- Use the shipping transit business days
[shipping_transit_business_days]
attribute if your transit business days aren’t the default Monday to Saturday and if you manually enter your transit times using the minimum transit time[fixed_min_transit_time]
and maximum transit time[fixed_max_transit_time]
sub-attributes. Enter these attributes when needed to give accurate delivery times to customers.
Shipping configuration | Transit time source | Shipping_transit_business_days application | Notes |
Shipping attribute | Merchant-defined | Applies | The merchant explicitly sets the transit time. |
Carrier shipping attribute | carrier_transit_time | Doesn't apply | Carrier-provided transit times are used. |
Carrier shipping attribute | fixed_transit_time | Applies | The merchant explicitly sets the transit time. |
- If you submit the attribute multiple times, avoid submitting conflicting information. For example, don’t submit 2 different prices for the same region.
- Submit shipping promotions through the promotions feed. For example, if you're offering free shipping for a 2 week summer sale, upload a shipping promotion in the merchant promotion feed and enter the dates that it is valid for. Using the code will give consumers free shipping when they check out on the website.
- Prominently state all additional charges that aren't related to shipping but relevant for the purchase during checkout. For example, list import duties, recycling fees, payment information, and service charges. Don’t submit this information as part of the tax or price attributes, instead bundle them with the Merchant Center shipping cost in the shipping attribute, or using the Merchant Center shipping services.
- Submit shipping costs for any region you ship to. If you don’t submit a shipping cost for a region that you ship to, either in your product data or through your account shipping settings, your product or account could be disapproved.
- Align your Shopping campaigns in Google Ads with your shipping settings and the availability of your product.
- Do not include government-imposed fees such as import duties, recycling fees, copyright fees, or state-specific retail delivery fees in the carrier_shipping cost.
Examples
Text formatting
To format the name, include "carrier_shipping
", and then in parentheses add the names of the sub-attributes that you’re submitting separated by a colon ( :
).
For example, to submit country [country]
, origin postal code [origin_postal_code]
, and carrier price [carrier_price]
:
Name carrier_shipping(country:origin_postal_code:carrier_price)
Format the value by submitting the value of each sub-attribute listed in the same order as in the name and separated with a colon ( :
).
For example:
Name carrier_shipping(country:origin_postal_code:carrier_price)
Possible value US:80302:USPS_MEDIA_MAIL
If you don’t include sub-attributes in the name, still submit values for all 5 sub-attributes in this order: country [country]
, origin postal code [origin_postal_code]
, carrier price [carrier_price]
, max handling time [max_handling_time]
, carrier transit time [carrier_transit_time]
.
For example:
Name carrier_shipping
Possible value US:94043:USPS_MEDIA_MAIL:3:USPS_MEDIA_MAIL
If you don’t want to provide an optional sub-attribute, like region [region]
, for a particular product, then still add a colon ( :
), but leave the text blank.
For example:
Name carrier_shipping(country:region:carrier_price)
Possible value US::USPS_MEDIA_MAIL
Repeated fields (regional shipping example)
Text
You can submit up to 10 carrier shipping values per item to indicate different costs for individual locations. Along with the shipping values, they can add up to 100. To submit multiple locations, submit the attribute (with the same name) multiple times. For example:
Product data for an orthopedic dog bed
Attribute | Value |
Title [title] |
XXL Orthopedic Dog Bed |
Max handling time [max_handling_time] |
2 |
Carrier shipping [carrier_shipping] |
US:94043:USPS_MEDIA_MAIL:USPS_MEDIA_MAIL |
Carrier shipping [carrier_shipping(country:region: |
US:HI:96815:USPS_MEDIA_MAIL |
Carrier shipping [carrier_shipping(country:region: |
US:AK:99518:USPS_PRIORITY_MAIL |
XML
To submit multiple delivery groups for an XML feed, include an additional attribute for each delivery group. You can submit up to 10 carrier shipping [carrier_shipping]
attributes for each product. Along with the shipping values, they can add up to 100.
<g:max_handling_time>2</g:max_handling_time>
<g:carrier_shipping>
<g:country>US</g:country>
<g:origin_postal_code>94043</g:origin_postal_code>
<g:carrier_price>USPS_MEDIA_MAIL</g:carrier_price>
<g:carrier_transit_time>USPS_MEDIA_MAIL</g:carrier_transit_time>
</g:carrier_shipping>
<g:carrier_shipping>
<g:country>US</g:country>
<g:region>HI</g:region>
<g:origin_postal_code>96815</g:origin_postal_code>
<g:carrier_price>USPS_MEDIA_MAIL</g:carrier_price>
</g:carrier_shipping>
<g:carrier_shipping>
<g:country>US</g:country>
<g:region>AK</g:region>
<g:origin_postal_code>99518</g:origin_postal_code>
<g:carrier_price>USPS_PRIORITY_MAIL</g:carrier_price>
</g:carrier_shipping>
Postal codes
For Australia, France, Germany, the United Kingdom, and the United States, you can submit ZIP codes or postal codes through the postal code [postal_code]
sub-attribute. There are several different ways you can submit these values depending on the region.
Australia and the United States
- Use a ZIP or postal code (for example, 94043).
- Use a range of postal codes (for example, 94002-95460).
- Use a range of postal codes using a prefix with a wildcard ( * ) (for example, 94*).
- Use a range of postal codes using 2 prefixes with wildcards ( * ) (for example, 94*-95*).
The United Kingdom
- Use the outward code (for example, if the postal code is N1C 4AG, use N1C).
- Use a range of outward codes (SW1A-SW1Y).
- Use a range of outward codes using an area code with a wildcard ( * ) (for example, N*). Include the full area without partial district code before *. For example, N* covers Northern London (N1 - N22), but not other area codes starting with N. For the North Western postcode area, you need to provide NW*.
Free shipping
Include free shipping by submitting a value of 0 USD in the currency of your target country for the price [flat_price]
sub-attribute of the carrier shipping [carrier_shipping]
attribute.