[installment]
attribute are not eligible for cross-border trade and can have only one targeted country.Use the installment [installment]
attribute to tell customers the details of a monthly installment payment plan that you offer.
In this article
When to use
Optional for each product
[installment]
attribute will account for a purchase financing or lease option for your vehicle including a down payment and recurring monthly installment payments. The price [price]
attribute will be treated as the full cash vehicle price.- Cars, Trucks & Vans (916)
[price]
attribute to specify the minimum total cost ("Minimum Quantifiable Price") of the device, including down payment, installment payments, and wireless subscription plan. Use the title [title]
attribute to indicate that the device is payable in installments.- Watches (201)
- Mobile Phone (267)
- Laptop Computers (328)
- Tablet Computers (4745)
- Mobile Phone Prepaid Cards & SIM Cards (6030)
- GPS Tracking Devices (6544)
The attribute is available for showing wireless products and services in the following countries:
- Africa: South Africa
- Asia-Pacific: Hong Kong, India, Japan, Malaysia, New Zealand, Singapore, South Korea, Taiwan, Thailand
- Europe: Austria, Belgium, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Norway, Poland, Portugal, Romania, Slovakia, Spain, Sweden, Switzerland, Turkey, United Kingdom
- Middle East: Israel, Saudi Arabia, United Arab Emirates
- North America: Canada, United States
Costs associated with a wireless subscription plan can also be added using the subscription cost [subscription_cost]
attribute in these countries, except the United States.
This attribute uses 4 sub-attributes:
- Months
[months]
(Required)
Integer, the number of installments the buyer has to pay. - Amount
[amount]
(Required)
ISO 4217, the amount the buyer has to pay per month. - Down payment
[downpayment]
(Optional)
ISO 4217, the amount the buyer has to pay upfront as a one time payment.- Note: the default option for this sub-attribute will be 0 or “no down payment”. Down payment is not supported in LATAM since down payments are uncommon in this region.
- Credit type
[credit_type]
(Optional)
Supported values: finance[finance]
, lease[lease]
. Defaults to finance[finance]
if unspecified. Only applicable to Vehicle Ads.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting.
Learn when and how to submit values in English
Type | Number plus currency |
---|---|
Repeated field | No |
File format | Example entry |
---|---|
Text feeds |
Format the attribute header by including the sub-attributes you’re submitting. Include installment For example, to submit
If you provide the two default sub-attributes Format the value by submitting the values for the sub-attributes separated with a colon ( 6:50 EUR:200 EUR |
XML feeds |
|
To format your data for Content API, see the Content API for Shopping resource.
Minimum requirements
These are the requirements 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.
- Match the installment plan that you display on your landing page. You can also display other installment options on your landing page, but the plan that you submit must be straightforward to find on the landing page.
- Don’t require that users have a loyalty card in order to choose the installment option that you submit.
- Avoid using the installment attribute for software subscriptions. Software subscriptions must be prepaid, and submit the yearly prepaid cost using the price
[price]
attribute. - Use in approved countries only. Use of the installment
[installment]
attribute in unapproved countries will result in disapproval of your product. - Use for approved product categories only. Use of the installment
[installment]
attribute for other categories of products will result in disapproval of your product.
Best practices
These best practices can help you go beyond the basic requirements to optimize your product data for performance.
- Submit exact values for your installment costs in accordance with ISO 4217. For example, submit 1.01 MXN instead of 1.0012 MXN, otherwise we will round the submitted value.
- If your product is combined with a subscription cost plan, submit the same number of months for the subscription cost
[subscription_cost]
attribute as for the installment[installment]
attribute. If the number of months is different and we need to combine your installment payment and subscription cost amounts due to space constraints, then we use the highest of the two values. For example, if your installment plan is 12 months, but your subscription contract is 24, then we will use 24 months.Note: The subscription cost[subscription_cost]
attribute is not supported in all countries. - If the installment amount for your product increases after a certain period of time, you must submit the highest monthly cost in the “amount” sub-attribute. For example, if the installment amount increases from 20 USD to 40 USD after 6 months, then specify 40 USD.
- For Vehicle Ads only, provide the credit type
[credit_type]
sub-attribute with a value of finance[finance]
or lease[lease]
to specify the type of installment credit provided. - For Vehicle Ads only, if the vehicle is not offered for a full cash vehicle price and is available for lease only, set the price
[price]
attribute to 0. For other product categories always specify the full up-front payment option using the price[price]
attribute. - For products targeting Latin America, the down payment
[downpayment]
sub-attribute should not be provided or be provided with a value of 0 since down payments are not supported.
Examples
Variants (Latin America only)If your product comes in multiple colors or sizes, you might also have different prices for each of these variants. For example:
Product data for green Android T-shirt, no downpayment | |
Attribute | Value |
ID [id] |
9876-S-GRN |
Title [title] |
Android T-Shirt - Green - Small |
Price [price] |
30 MXN |
Installment [installment] |
3:10 MXN |
Color [color] |
Green |
Size [size] |
S |
ID [id] |
9876-S-GRN |
Item Group ID [item_group_id] |
9876 |
Product data for blue Android T-shirt, no downpayment | |
Attribute | Value |
ID [id] |
9876-S-GRN |
Title [title] |
Android T-Shirt - Blue - Small |
Price [price] |
30 MXN |
Installment [installment] |
3:10 MXN |
Color [color] |
Blue |
Size [size] |
S |
Item Group ID [item_group_id] |
9876 |
Product data for yellow Android T-shirt, no downpayment | |
Attribute | Value |
ID [id] |
9876-S-GRN |
Title [title] |
Android T-Shirt - Yellow - Small |
Price [price] |
30 MXN |
Installment [installment] |
3:10 MXN |
Color [color] |
Yellow |
Size [size] |
S |
Item Group ID [item_group_id] |
9876 |
Submit the full up-front payment price for the device in the price [price]
attribute as well as an installment option (with a down payment as low as 0) in the installment [installment]
attribute.
Product data for a midnight blue Google Nexus 6- 32 GB priced at a 900 USD full payment at checkout or an alternative installment payment option with a 200 USD down payment. | |
Attribute | Value |
Title [title] |
Google Nexus 6 - 32 GB - Midnight Blue - (with 24 monthly payments) |
Price [price] |
900 USD (full payment at checkout) |
Installment [installment] |
24:29.95 USD:200 USD |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
Product data for a black Google Nexus 9- 32 GB priced at 300 EUR full up-front payment or an alternative monthly installment payment option with a 0 EUR down payment. | |
Attribute | Value |
Title [title] |
Google Nexus 9 - 32 GB - Black - (with 12 monthly payments) |
Price [price] |
300 EUR |
Installment [installment] |
12:30 EUR:0 EUR |
Google product category [google_product_category] |
Electronics > Computers > Tablet Computers |
Phone or tablet sold with installment payments and bundled with a subscription plan
[price]
attribute as well as an installment option (with a down payment as low as 0) in the installment [installment]
attribute. Specify in your title that your wireless product requires a subscription plan of a certain duration and installment payments. Learn more about the price attribute.[subscription_cost]
is not available in the US or Latin America.
Product data for a midnight blue Google Nexus 6- 32 GB with 18 EUR monthly installment payment option. 0 downpayment. 5 EUR activation fee. | |
Attribute | Value |
Title [title] |
Google Nexus 6 - 32 GB - Midnight Blue - (with contract, 12 installment payments) |
Price [price] |
221 EUR |
Installment [installment] |
12:18 EUR:5 EUR |
Subscription cost [subscription_cost] |
month:12:10.00 EUR |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
Phone or tablet sold with installment payments (Latin America countries only)
[price]
attribute. Also provide an alternative monthly installment payment option using the installment [installment]
attribute. LATAM doesn’t support down payments, so the downpayment doesn’t need to be provided.Product data for a midnight blue Google Nexus 6- 32 GB priced at 1,080.00 BRL, with installment payment options | |
Attribute | Value |
Title [title] |
Google Nexus 6 - 32 GB - Midnight Blue |
Price [price] |
1080 BRL |
Installment [installment] |
12:95 BRL |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
The subscription cost [subscription_cost]
attribute should not be included since there is no service contract.
Learn more about the best practices for advertising wireless products and services.
Phone or tablet sold with installment payments (Australia only)
[price]
attribute. Use the title [title]
attribute to specify that your wireless product is sold with an installment payment plan. Learn more about the price attributeAttribute | Value |
Title [title] |
Google Pixel 4 - 32 GB - Midnight Blue with 12 monthly payments |
Price [price] |
1500 AUD |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |
The installment [installment]
attribute and the subscription cost [subscription_cost]
attribute shouldn't be included.
Vehicle sold with installment payments (Vehicle Ads only)
Attribute | Value |
Installment [installment] |
36:20000 GBP:1000 GBP:lease |
Google product category [google_product_category] |
Vehicles & Parts > Vehicles > Motor Vehicles > Cars, Trucks & Vans |