The carrier delivery [carrier_shipping]
attribute lets you provide delivery speed and cost for a product based on a carrier service. Delivery cost and speed will be calculated based on the origin location and the customer's location.
Use this attribute when the account delivery settings for your product are not defined in Merchant Center or when you need to override the delivery settings that you set up in Merchant Center. You need to submit delivery weight [shipping_weight]
and preferably add delivery dimensions to use carrier-based delivery cost.
In this article
When to use
Optional
Carrier costs and speeds provide more accurate delivery costs and speeds for customers as their location is used to determine the delivery cost and transit time. Instead of providing cost and transit time directly, you can provide the carrier service that you use and where you deliver from. For example, 'I deliver with US Mail carrier service from my warehouse in 94043'.
Sub-attributes
The carrier delivery [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 (e.g. 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). - Postcode
[postal_code]
(optional)
Submit a postcode range. This is supported for Australia, Brazil, Canada, France, Germany, India, New Zealand and the United States.- Use a ZIP or postcode (e.g. 94043 for the US and 2009 for Australia).
- Use a range of postcodes (e.g. 94002–95460 for the US and 2009–3000 for Australia).
- Use a range of postcodes using a prefix with a wildcard (*) (e.g. 94*).
- Use a range of postcodes using two prefixes with wildcards (*) (e.g. 94*–95*).
- Region
- Origin postal code
[origin_postal_code]
(required)
The origin postal code[origin_postal_code]
is the domestic ZIP code or postcode of the country that is added in the country[country]
sub-attribute and from where the order is being dispatched. For example, 94043 for US and 2009 for Australia.
The United Kingdom
- Shipping price (required to provide delivery speed overrides; otherwise optional)
To specify delivery cost, submit one (and only one) of the following:- Manual price
[flat_price]
-
Submit a fixed delivery cost and use a full stop [.] as the decimal separator (e.g. 3.00 GBP). 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 delivery [carrier_shipping]
attribute, the account delivery service settings (including 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 it. 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 delivery cost and use a full stop [.] as the decimal separator. For example: 3.00 GBP. 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 delivery 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 delivery carrier.
- Minimum handling time
You may also use the standalone handling time attributes instead of the delivery handling time sub-attributes. If both are present, then the delivery sub-attributes will be used.
Refrain from using both the carrier delivery [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 delivery sub-attributes will override standalone handling time attributes.
Use working days. For example, if a customer orders on Tuesday and the delivery leaves the warehouse on Friday at the latest, the maximum handling time is three days.
- Transit time (optional)
To specify how long a product may spend in transit, submit one of the following options. Please note that when the minimum and maximum transit time and carrier transit time are provided, carrier delivery 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 delivery 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 delivery 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 delivery 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 delivery[carrier_shipping]
or the standalone attribute. - The transit time, either manually with the fixed max transit time
[fixed_max_transit_time]
sub-attribute or by selecting a carrier in the carrier transit time[carrier_transit_time]
sub-attribute of the carrier delivery[carrier_shipping]
attribute. - A value for the price, either by manually inputting flat price
[flat_price]
or by selecting carrier in the carrier price[carrier_price]
sub-attribute of the carrier delivery[carrier_shipping]
attribute.
These are required for the handling time and transit time to be considered valid. Multiple carriers and different delivery locations will require multiple delivery attributes.
Format
Follow these formatting guidelines to make sure that Google understands the data that you're submitting.
Type | Unicode characters (recommended: ASCII only) |
Repeated field (what's this?) |
Submit the delivery 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 delivery Name If you name the sub-attributes that you're using, you can provide 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 delivery cost for different delivery locations, submit the carrier delivery
|
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, take a look at the Content API for Shopping resource.
Supported carrier services
Australia
* Carrier-based delivery speed is not yet supported in Australia.
Australia Post | |||
Carrier service | Enumeration value | Delivery cost: | Delivery 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 | Delivery cost: | Delivery speed |
Road Express | TNT_ROAD_EXPRESS |
||
Overnight Express | TNT_OVERNIGHT_EXPRESS |
||
Toll | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Road Delivery | TOLL_ROAD_DELIVERY |
||
Overnight Priority | TOLL_OVERNIGHT_PRIORITY |
France
* Carrier-based delivery cost is not yet supported in France.
Colissimo | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Domicile | COLISSIMO_DOMICILE |
||
DHL | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Express 12.00 a.m. | DHL_EXPRESS_12AM |
||
Express 9.00 a.m. | DHL_EXPRESS_9AM |
||
Geodis | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Express delivery | GEODIS_EXPRESS |
||
Pack 30 | GEODIS_PACK_30 |
||
Same-day Solutions | GEODIS_SAME_DAY |
||
Top 24 | GEODIS_TOP_24 |
||
TNT | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Essentiel 24h | TNT_ESSENTIEL_24H |
||
Essentiel flexibilité | TNT_ESSENTIEL_FLEXIBILITE |
Germany
DHL | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Paket | DHL_PAKET |
||
Päckchen | DHL_PACKCHEN |
||
ExpressEasy | DHL_EXPRESSEASY |
||
DPD | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Express 12 | DPD_EXPRESS_12 |
||
Express | DPD_EXPRESS |
||
Classic Parcel | DPD_CLASSIC_PARCEL |
||
Hermes | |||
Carrier service | Enumeration value | Delivery cost: | Delivery 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 | Delivery cost: | Delivery speed |
Express | UPS_EXPRESS |
||
Express Saver | UPS_EXPRESS_SAVER |
||
Express Standard | UPS_EXPRESS_STANDARD |
||
GLS | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Business Parcel | GLS_BUSINESS |
||
Express Parcel | GLS_EXPRESS |
||
Private National | GLS_PRIVATE |
United Kingdom
DHL | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Express | DHL_EXPRESS |
||
Express 12 | DHL_EXPRESS_12 |
||
DPD | |||
Carrier service | Enumeration value | Delivery cost: | Delivery 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 | Delivery cost: | Delivery 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 | Delivery cost: | Delivery speed |
Express | TNT_EXPRESS |
||
Express 10 | TNT_EXPRESS_10 |
||
Express 12 | TNT_EXPRESS_12 |
||
UPS | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
Express | UPS_EXPRESS |
||
Express Saver | UPS_EXPRESS_SAVER |
||
Standard | UPS_STANDARD |
||
Yodel | |||
Carrier service | Enumeration value | Delivery cost: | Delivery speed |
B2C 48 HR | YODEL_B2C_48HR |
||
B2C 72 HR | YODEL_B2C_72HR |
||
B2C Packet | YODEL_B2C_PACKET |
United States
FedEx | |||
Carrier service | Enumeration value | Delivery cost: | Delivery 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 |
||
2 Day | FEDEX_2DAY |
||
UPS | |||
Carrier service | Enumeration value | Delivery cost: | Delivery 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 | Delivery cost: | Delivery 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 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.
- Submit complete and correct delivery information, including speed and costs.
- To properly use carrier-based delivery cost, it is also required to include the following attributes:
- delivery weight
[shipping_weight]
- delivery length
[shipping_length]
- delivery width
[shipping_width]
- delivery height
[shipping_height]
- delivery weight
- Delivery speed and cost are two of the most common reasons why shoppers abandon a product, so make sure that your delivery settings are accurate and up to date to make your ads and listings effective.
- Include all relevant delivery 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 delivery cost. Match or overestimate the cost that users would pay. Please note that overestimating excessively may negatively impact your product performance.
- Use the rate for delivery directly to an individual. Don't use other rates such as the rate for delivery to a shop or a rate that requires a membership to be applicable.
- Display product details on your landing page to all users. Ensure that when a user clicks your ad, they can view details about your product, even if you don't deliver to the user's location.
- Comply with local laws when submitting delivery information.
- Provide the country sub-attribute. Always provide the country
[country]
sub-attribute of the carrier delivery[carrier_shipping]
attribute to ensure that your products are dispatched correctly.
Best practices
These best practices can help you to go beyond the basic requirements to optimise your product data for performance.
- Use account delivery settings in Merchant Center. With these settings you can create simple flat rates or complex, custom models. Use the carrier delivery
[carrier_shipping]
attribute as a last resort to override the settings that you create in Merchant Center. - When selecting a carrier for shipping price, ensure that 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 GBP, submit 1.01 GBP. 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 delivery transit time, ensure that the selected carrier is correctly written as the enumeration value listed.
- Use the delivery handling working days
[shipping_handling_business_days]
- Use the delivery transit working days
[shipping_transit_business_days]
attribute if your transit working 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 provide customers with accurate delivery times.
Delivery configuration | Transit time source | Shipping_transit_business_days application | Notes |
Delivery attribute | Merchant-defined | Applies | The merchant explicitly sets the transit time. |
Carrier delivery attribute | carrier_transit_time | Doesn't apply | Carrier-provided transit times are used. |
Carrier delivery 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 two different prices for the same region.
- Submit delivery promotions through the promotions feed. For example, if you're offering free delivery for a two-week summer sale, upload a delivery promotion in the merchant promotion feed and enter the dates that it is valid for. Using the code will give consumers free delivery when they check out on the website.
- Prominently state all additional charges that aren't related to delivery 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 delivery cost in the delivery attribute or using the Merchant Center delivery services.
- Submit delivery costs for any region that you deliver to. If you don't submit a delivery cost for a region to which you deliver, either in your product data or through your account delivery settings, your product or account could be disapproved.
- Align your Shopping campaigns in Google Ads with your delivery 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 postcode [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 four 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 delivery example)
Text
You can submit up to 10 carrier delivery values per item to indicate different costs for individual locations. Along with the delivery 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 orthopaedic dog bed
Attribute | Value |
Title [title] |
XXL Orthopaedic Dog Bed |
Max handling time [max_handling_time] |
2 |
Carrier delivery [carrier_shipping] |
US:94043:USPS_MEDIA_MAIL:USPS_MEDIA_MAIL |
Carrier delivery [carrier_shipping(country:region: |
US:HI:96815:USPS_MEDIA_MAIL |
Carrier delivery [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 delivery [carrier_shipping]
attributes for each product. Along with the delivery 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>
Postcodes
For Australia, France, Germany, the United Kingdom and the United States, you can submit ZIP codes or postcodes through the postcode [postal_code]
sub-attribute. There are several different ways in which you can submit these values depending on the region.
Australia and the United States
- Use a ZIP code or postcode (for example, 94043).
- Use a range of postcodes (e.g. 94002–95460).
- Use a range of postcodes using a prefix with a wildcard (*) (e.g. 94*).
- Use a range of postcodes using two prefixes with wildcards (*) (e.g. 94*–95*).
The United Kingdom
- Use the outward code (e.g. if the postcode 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 (*) (e.g. N*). Include the full area without partial district code before *. For example, N* covers North London (N1–N22) but not other area codes starting with N. For the North Western postcode area, you need to provide NW*.
Free delivery
Include free delivery by submitting a value of 0 USD in the currency of your target country for the price [flat_price]
sub-attribute of the carrier delivery [carrier_shipping]
attribute.