Free delivery threshold [free_shipping_threshold]

Free delivery threshold is the minimum order cost above which delivery is free. For example, free delivery for orders over $100. For orders below $100, the standard delivery [shipping] rate will apply.

In this article

• When to use
• Format
• Best practices

---

When to use

It depends

If you use the delivery [shipping] attribute to display offer-level delivery information, use the free delivery threshold [free_shipping_threshold] attribute to indicate an order cost above which delivery is free.

Note: If the offer's free delivery condition is met, 'Free delivery' is displayed on your ad.

Sub-attributes

The free delivery threshold [free_shipping_threshold] attribute uses sub-attributes to define country and condition for free delivery.

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).
• Price threshold [price_threshold] (required)
  To indicate the price above which delivery is free. Submit a fixed order cost and use a full stop [.] as the decimal separator; for example, 100.00 USD. Avoid commas [,] to ensure that the price is interpreted correctly.

---

Format

Follow these formatting guidelines to make sure that Google understands the data that you're submitting. Learn how to submit attributes and attribute values.

Type	Number plus currency (use ISO 4217)
Repeated field	Submit the free delivery threshold [free_shipping_threshold] attribute up to 25 times per product

File format	Example entry
Text (TSV)	Include free delivery threshold in the header, and indicate country and price threshold separated by a colon (:). 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: Country [country] Price threshold [price_threshold] Name free_shipping_threshold (country:postal_code) Possible value US:100 USD To submit the free delivery threshold for different delivery locations, submit the free delivery threshold [free_shipping_threshold] attribute multiple times. Name free_shipping_threshold Possible value US:100 USD Name free_shipping_threshold Possible value CA:90 CAD
XML (feeds)	To submit the free delivery threshold for different delivery locations, submit the free delivery threshold [free_shipping_threshold] attribute multiple times, including the sub-attributes for each. <g:free_shipping_threshold> <g:country>US</g:country> <g:price_threshold>100 USD</g:price_threshold> </g:free_shipping_threshold> <g:free_shipping_threshold> <g:country>CA</g:country> <g:price_threshold>150 CAD</g:price_threshold> </g:free_shipping_threshold>

To format your data for Content API, see the Content API for Shopping resource.

---

Best practices

• Submit an order price that can be represented in the 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 the target country's currency, we'll round it to a value that can.
• The free delivery threshold currency must be the same as the offer's price currency.
• Submit a different free delivery value for every country that you deliver to.
• Avoid submitting conflicting information. For example, don't submit two different free delivery threshold configurations for the same country.