installment: Definition

 
Use the installment attribute to tell users the details of a monthly installment payment plan that you offer to pay for your product.

When to use

This attribute is only available in certain 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
  • Latin America: Argentina, Brazil, Chile, Colombia, Mexico, Peru
  • Middle East: Israel, Saudi Arabia, United Arab Emirates
  • North America: Canada, United States

Use this attribute to tell users if there is a monthly installment plan to pay for your product.

Australia: This attribute should not be used for wireless devices such as mobile phones or tablets advertised in Australia. Use the 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 attribute to indicate that the device is payable in installments.
Outside Latin America: The price attribute (as low as 0) will be treated as the up-front payment (including any device down payment and activation fees), and the installment attribute will account for recurring monthly installment payments for your wireless device. Costs associated with a wireless subscription plan can also be added using the subscription_cost attribute.
Latin America countries only: Installment payment plans are supported for all product categories. An offer that uses the installment attribute is treated as an offer where the product can be purchased by either paying the price up-front or paying in installments. Use the price attribute to provide the full payment amount and the installment attribute to indicate alternative installment payments and frequency.

This attribute is only available for mobile products with the following Google product category codes:

  • Watches (201)
  • Mobile Phone (267)
  • Tablet Computers. (4745)
  • Mobile Phone Prepaid Cards & SIM Cards (6030)
  • GPS Tracking Devices (6544)

The installment attribute uses 2 sub-attributes:

  • months (required)
    Integer, the number of installments the buyer has to pay.
  • amount (required)
    ISO 4217, the amount the buyer has to pay per month.

Format

Follow these formatting guidelines to make sure we understand the data you're submitting. 

Type Number plus currency
Repeated field No
File format Example entry
Text feeds

Format the value by submitting the months and amount separated with a colon ( : ). Don’t use quotation marks. For example, for 6 monthly payments of 50 BRL each, submit:


6:50 BRL
XML feeds

<g:installment>

<g:months>6</g:months>

<g:amount>50 BRL</g:amount>

</g:installment>

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

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products.

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 Diagnostics 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 to choose the installment option that you submit.
  • Don't use the installment attribute for software subscriptions. Software subscriptions must be prepaid, and submit the yearly prepaid cost using the price attribute.
  • Don’t include activation fees in the price attribute for products sold in the US. Subscription plans are not supported in the US.
  • Use in approved countries only. Use of the installment attribute in unapproved countries will result in disapproval of your product.
  • Use for approved product categories only. Use of the 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 accordingly to 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 attribute as for the 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 attribute is only supported in countries where installments are supported.
  • 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.

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:

An example of ads without placeholder images

Product data for green Android T-shirt
Attribute Product data
id 9876-S-GRN
title Android T-Shirt - Green - Small
price 30 MXN
installment 3:10 MXN
color green
size s
id 9876-S-GRN
item_group_id 9876

 

Product data for blue Android T-shirt
Attribute Product data
id 9876-S-GRN
title Android T-Shirt - Blue - Small
price 30 MXN
installment 3:10 MXN
color blue
size s
item_group_id 9876
Product data for yellow Android T-shirt
Attribute Product data
id 9876-S-GRN
title Android T-Shirt - Yellow - Small
price 30 MXN
installment 3:10 MXN
color yellow
size s
item_group_id 9876
Mobile phone or tablet sold with installment payments

You can submit a price as low as 0 for mobile phones or tablets that come with monthly installment payments. Learn more about price requirements.

An illustration with 3 different colors of one mobile phone

Product Google Nexus 6
title Google Nexus 6 - 32 GB - Midnight Blue - (with 24 monthly payments)
price 36.95 USD (up-front payment at checkout)
installment 24:29.95 USD
google_product_category Electronics > Communications > Telephony > Mobile Phones

 

Product Google Nexus 9
title Google Nexus 9 - 32 GB - Black - (with 12 installment payments)
price 0 EUR
installment 12:30 EUR
google_product_category Electronics > Computers > Tablet Computers

Phone or tablet sold with installment payments and bundled with a subscription plan

Submit a total value for the down payment (as low as 0) in the price attribute and include any activation fees and/or one-time charges. Submit zero in the price attribute if there are no up-front costs. 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.
Note: subscription_cost is not available in the US or Latin America.
An illustration with 3 different colors of one mobile phone
Product Google Nexus 6
title Google Nexus 6 - 32 GB - Midnight Blue - (with contract, 12 monthly payments)
price 40 EUR
installment 12:18 EUR
subscription_cost month:12:10.00 EUR
google_product_category Electronics > Communications > Telephony > Mobile Phones
Product Google Nexus 9
title Google Nexus 9 - 32 GB - Black - (with contract, 24 monthly payments)
price 0 EUR
installment 24:10 EUR
subscription_cost month:24:10.00 EUR
google_product_category Electronics > Computers > Tablet Computers

Phone or tablet sold with installment payments (Latin America countries only)

Submit a total value for the purchase amount in the price attribute. Also provide an alternative monthly installment payment option using the installment attribute. Specify in your title that your wireless product is sold with an installment payment plan. Learn more about the price attribute.
An illustration with 3 different colors of one mobile phone
Product Google Nexus 6
title Google Nexus 6 - 32 GB - Midnight Blue - 12 monthly installments
price 1080 BRL
installment 12:95 BRL
subscription_cost (must be empty because there is no service contract)
google_product_category Electronics > Communications > Telephony > Mobile Phones
Product Google Nexus 9
title Google Nexus 9 - 32 GB - Black - 24 monthly installments
price 1800 BRL
installment 24:10 BRL
subscription_cost (must be empty because there is no service contract)
google_product_category Electronics > Computers > Tablet Computers

Phone or tablet sold with installment payments (Australia only)

Submit the total minimum cost of the device including installment payments in the price attribute. Use the title attribute to specify that your wireless product is sold with an installment payment plan. Learn more about the price attribute
Product Pixel 4
title Google Pixel 4 - 32 GB - Midnight Blue - 12 monthly installments
price 1500 AUD
installment (must be empty)
subscription_cost (must be empty)
google_product_category Electronics > Communications > Telephony > Mobile Phones
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue