The minimum order value [minimum_order_value] attribute allows you to set up the minimum spend required for an order. If a product's price is less than the minimum spend for an order that includes that product, you must set the minimum order value for that product.
Shoppers will view this value on your ads and cost-free listings so that they know about minimum order value restrictions before going to your website. Being up front with this information prevents you from paying for clicks from users who don't intend to buy additional products.
On this page
When to use
It depends
Minimum order value can be provided using the minimum order value [minimum_order_value] attribute or at the account level. If you specify a minimum order value for an individual product, it overrides any minimum order value specified at the account level. Only specify a minimum order value when your product's price is equal to or less than than the minimum order value.
Learn more about adding a minimum order value in Merchant Center.
For in-store products: Minimum order value [minimum_order_value] is required for in-store products in the United Kingdom as well as EU and EFTA countries if your website requires a minimum spend for customers to buy or reserve products online for click and collect. |
Note: If you use the delivery [shipping] or carrier delivery [carrier_shipping] attributes to specify your delivery costs, this will override your account-level settings, including the minimum order value that you set at the account level in your delivery settings. Make sure that you set the minimum order value attribute if you specify the delivery [shipping] or carrier delivery [carrier_shipping] attributes and need to define a minimum order value.
The minimum order value [minimum_order_value] attribute can be used in all countries, including those that do not require or display delivery costs.
Sub-attributes
Minimum order value [minimum_order_value]has four sub-attributes:
- Country
[country](required)
The country that the product can be delivered to. Submit an ISO 3166-1 country code (e.g. CH).
- Service
[service](optional)
Use this sub-attribute if you have multiple delivery options for a single location, each with a different associated minimum spend. For example, 'Standard' and 'Express' delivery options, or specific loyalty-related (member programme and tier) delivery options. The value provided here will be matched against the same value provided for the service [service] sub-attribute in the delivery [shipping] attribute to match the right minimum order value to the right delivery option.
- Surface
[surface](optional)
The destinations that the specified minimum order value applies to. Either online [online], local [local] or online plus local [online_local]. If not specified, the minimum order value applies to all destinations (online plus local [online_local]).
- Price
[price](required)
The minimum spend required to place an order delivered to the specified country. Use a point [.] as the decimal separator. For example, 100.00 GBP. 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 more how to submit attributes and attribute values.
| Type | Unicode characters. Recommended: ASCII only |
| Repeated field | Yes (max. 100 per product) |
|
Schema.org property (What's this?) |
No |
| File format | Example value |
| Text feeds |
Note: TSV (tab-separated) text file is recommended. Header: Format the attribute header by including the sub-attributes that you're submitting. Include minimum order value Value: Format the value by submitting the value of each sub-attribute listed in the same order as in the header and separated by a colon ( For example, to submit country, service and price: Header: Possible value: If you name the sub-attributes that you're using in the header, you can give them to us in any order. However, if you do not name them (and only provide the attribute name), we'll assume that your attribute values include the two required sub-attributes in this order:
For example, to submit only country and price: Header: Possible value: If you don't need to provide an optional sub-attribute for some products or attribute values, then still add a colon ( Header: Possible values: Note: Always provide the same number of sub-attributes as you are submitting in the header. Missing sub-attributes in the header will lead to formatting errors and you will see a warning 'Invalid format for sub-attributes |
| XML feeds |
|
To format your data in Merchant API, check the Merchant API documentation.
Minimum requirements
These are the requirements that you'll need to meet to show your minimum order value on Google.
- Only specify a minimum order value when your product's price is equal to or less than the minimum order value.
- If you need to specify a minimum order value and you specify the delivery
[shipping]or carrier delivery[carrier_shipping]attributes for your product, you need to provide the minimum order value[minimum_order_value]attribute even if you have a minimum order defined in your account-level delivery settings.
- Ensure that the currency of the price
[price]sub-attribute of the minimum order value[minimum_order_value]attribute matches the currency of the price[price]attribute.
Ensure that the data provided to Google matches what's showcased on your website. Google will check to make sure that the minimum order value submitted in Merchant Center aligns with the information displayed on your website.
Examples
Text formatting
- To format the name, include '
minimum_order_value', and then, in brackets, add the names of the sub-attributes that you're submitting, separated by a colon (:).
For example, to submit country [country], surface [surface] and price [price]:
Name minimum_order_value(country:surface:price)
- Format the value by submitting the value of each sub-attribute listed in the same order as in the name and separated by a colon (:).
For example:
Name minimum_order_value(country:surface:price)
Possible value DE:online:25 EUR
Possible value CA:local:29.99 CAD
- You can also just submit the country and price, in which case you do not need to specify the sub-attributes in the name.
For example:
Name minimum_order_value
Possible value CH:25 CHF
- If you don't want to provide an optional sub-attribute (like
service) for a particular product, then still add a colon (:), but leave the text blank.
For example:
Name minimum_order_value(country:service:price)
Possible value GB::25 GBP
For example (multiple values):
Name minimum_order_value(country:service:price)
Possible value GB:standard:29.99 GBP,GB:express:50 GBP