Free shipping threshold [free_shipping_threshold]

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

In this article

• When to use
• Format
• Best practices

---

When to use

It depends

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

Note: If the offer's free shipping condition is met, “Free Shipping” is displayed on your ad.

Sub-attributes

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

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 [price] above which shipping is free, submit a fixed order cost, and use a period [.] as the decimal separator. For example, 100.00 USD. Avoid commas [,] to ensure that the price is interpreted correctly. The price threshold [price_threshold] looks at the base price [price] attribute of the product.

---

Format

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

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

File format	Example entry
Text (TSV)	Include free shipping threshold in the header, and indicate country and price threshold separated by a colon ( : ). 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: Country [country] Price threshold [price_threshold] Name free_shipping_threshold (country:price_threshold) Possible value US:100 USD To submit the free shipping threshold for different delivery locations, submit the free shipping 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 shipping threshold for different delivery locations, submit the free shipping 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, view 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, then we’ll round it to a value that can.
• The free shipping threshold currency must be the same as the offer's price currency.
• Submit a different free shipping value for every country that you ship to.
• Avoid submitting conflicting information. For example, don’t submit two different free shipping threshold configurations for the same country.