installment: Definition

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

When to use

Use this attribute to tell users if there is a monthly installment plan to pay for your product. In all countries besides Brazil and Mexico, the price attribute will be treated as the up-front payment, and the installment attribute will account for monthly installments in addition.

Brazil and Mexico only: An offer with non-zero price attribute and an installment attribute will be treated as an offer where the product can be purchased by either paying the price up-front or paying in installments. 
 

The installment attribute uses 2 sub-attributes:

  • months (required) 
    Integer, the number of installments the buyer has to pay.
  • amount (optional)
    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>

Content API v2 (JSON)

"installment": {

   "months": 6,

   "amount": {

       "value": "50",

       "currency": "BRL"

   }

}

Content API v2 (XML)

<installment>

  <month>6</month>

  <amount currency="BRL">50</amount>

</installment>

Guidelines

Follow these guidelines to make sure you submit high-quality data for your products and get the best performance from your ads.

Minimum requirements

These are the requirements you'll need to meet to show ads for your product. If you don't follow these requirements, we'll disapprove your product and let you know in the Diagnostics page of your Merchant Center account. 

  • Meet the requirements of the price attribute with the amount that you submit for installment.
  • Submit the price attribute with the total price for the product.
  • 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.

Best practices

These are best practices that 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.

Examples

Variants

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
Phone or tablet in installments (Germany, France, United Kingdom, Republic of Ireland, and South Korea only)

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

An illustration with 3 different colors of one mobile phone

Product Google Nexus 6
title Google Nexus 6 - 32 GB - Midnight Blue - With contract
price 1080 BRL
installment 12:90 BRL
google_product_category Electronics > Communications > Telephony > Mobile Phones

 

Product Google Nexus 9
title Google Nexus 9 - 32 GB - Black - With contract
price 1800 BRL
installment 24:75 BRL
google_product_category Electronics > Computers > Tablet Computers

Phone or tablet sold in installments and bundled with a service contract (Germany, France, United Kingdom, Republic of Ireland and South Korea only)

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 contract of a certain duration and an installment 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 - With contract and sold in 12 installments
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 and sold in 24 installments
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 in installments (Mexico and Brazil only)

Submit a total value for the up-front purchase amount in the price attribute and include any activation fees and/or one-time charges. Specify in your title that your wireless product is sold with an installment 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:90 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 in installments (US only) 

Submit a total value for the up-front purchase amount (as low as 0) in the price attribute and include any activation fees and/or one-time charges. Specify in your title that your wireless product is sold with an installment 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 43 USD
installment 12:43 USD
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 75 USD
installment 24:75 USD
subscription_cost (must be empty because there is no service contract)
google_product_category Electronics > Computers > Tablet Computers
Was this article helpful?
How can we improve it?