The minimum order value [minimum_order_value] attribute allows setting 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 free listings so 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 and EU and EFTA countries if your website requires a minimum spend for customers to buy or reserve products online for in-store pickup. |
Note: If you use the shipping [shipping] or carrier shipping [carrier_shipping] attributes to specify your shipping costs, this will override your account-level settings, including the minimum order value that you set at the account-level in your shipping settings. Make sure to set the minimum order value attribute if you specify the shipping [shipping] or carrier shipping [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 shipping costs.
Sub-attributes
Minimum order value [minimum_order_value]has 4 sub-attributes:
- Country
[country](Required)
The country that the product can be delivered to. Submit an ISO_3166-1 country code (for example: CH).
- Service
[service](Optional)
Use this sub-attribute if you have multiple shipping options for a single location, each having a different associated minimum spend. For example, “Standard” and “Express” shipping options, or specific loyalty (member program and tier) related shipping options. The value provided here will be matched against the same value provided for the service [service] sub-attribute in the shipping [shipping] attribute to match the right minimum order value to the right shipping option.
- Surface
[surface](Optional)
The destinations 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 shipped to the specified country. Use a period [.] 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 Google understands the data 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 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 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 2 required sub-attributes in this order:
For example, to only submit 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 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 lesser than the minimum order value.
- If you need to specify a minimum order value and you specify the shipping
[shipping]or carrier shipping[carrier_shipping]attributes for your product then you need to provide the minimum order value[minimum_order_value]attribute even if you have a minimum order defined in your account-level shipping 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 the data provided to Google matches what’s showcased on your website. Google will check to make sure 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 parentheses 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 with 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 US::25 USD
For example (multiple values):
Name minimum_order_value(country:service:price)
Possible value US:standard:29.99 USD,US:express:50 USD