installment [instalment]: Definition

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

When to use

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

In countries outside Latin America, you can only use instalment payments for mobile phones and tablets. The price [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 [instalment] attribute will account for recurring monthly instalment payments for your wireless device. Costs associated with a wireless subscription plan can also be added using the subscription_cost [subscription_cost] attribute. Learn more about subscription_cost [subscription_cost]

Latin America countries only: An offer that uses the installment [instalment] attribute will be treated as an offer where the product can be purchased by either paying the price up front or paying in instalments. Use the price [price] attribute to provide the full payment amount and the installment [instalment] attribute to indicate alternative instalment payments and frequency.

The installment [instalment] attribute uses 2 sub-attributes:

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

Format

Follow these formatting guidelines to make sure that we understand the data that 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 by a colon ( : ). Don't use quotation marks. For example, for 6 monthly payments of 50 GBP each, submit:


6:50 GBP

 

XML feeds

<g:installment>

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

  <g:amount>50 GBP</g:amount>

</g:installment>


For format API information, please see Content API for Shopping.

Guidelines

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

Minimum requirements

These are the requirements that 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 on the Diagnostics page of your Merchant Center account. 

  • Match the instalment plan that you display on your landing page. You can also display other instalment 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 instalment option that you submit.
  • Don't use the instalment 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 [price] attribute for products sold in the US. Subscription plans are not supported for Shopping ads in the US.

Best practices

These are best practices that can help you go beyond the basic requirements to optimise your product data for performance. 

  • Submit exact values for your instalment 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 (Latin America only)

If your product comes in multiple colours 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 [ID] 9876-S-GRN
title [title] Android T-shirt – Green – Small
price [price] 30 MXN
installment [instalment] 3:10 MXN
color [colour] green
size [size] S
id [id] 9876-S-GRN
item_group_id [item_group_id] 9876

 

Product data for blue Android T-shirt
Attribute Product Data
id [ID] 9876-S-GRN
title [title] Android T-shirt – Blue – Small
price [price] 30 MXN
installment [instalment] 3:10 MXN
color [colour] blue
size [size] s
item_group_id [item_group_id] 9876

 

Product data for yellow Android T-shirt
Attribute Product Data
id [ID] 9876-S-GRN
title [title] Android T-shirt – Yellow – Small
price [price] 30 MXN
installment [instalment] 3:10 MXN
color [colour] yellow
size [size] s
item_group_id [item_group_id] 9876
Mobile phone or tablet sold with instalment payments

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

An illustration with 3 different colors of one mobile phone

Product Google Nexus 6
title [title] Google Nexus 6 – 32 GB – Midnight Blue – With instalment payments
price [price] 36.95 USD (up-front payment at checkout)
installment [instalment] 24:29.95 USD
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones

 

Product Google Nexus 9
title [title] Google Nexus 9 – 32 GB – Black – With instalment payments
price [price] 0 EUR
installment [instalment] 12:30 EUR
google_product_category [google_product_category] Electronics > Computers > Tablet Computers

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

Submit a total value for the down payment (as low as 0) in the price [price] attribute and include any activation fees and/or one-off charges. Submit zero in the price [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 instalment payments. Learn more about the price attribute

Note: subscription_cost [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 [title] Google Nexus 6 – 32 GB – Midnight Blue – With contract and sold in 12 instalments
price [price] 40 EUR
installment [instalment] 12:18 EUR
subscription_cost [subscription_cost] month:12:10.00 EUR
google_product_category [google_product_category] Electronics > Communications > Telephony > Mobile phones

 

Product Google Nexus 9
title [title] Google Nexus 9 – 32 GB – Black – With contract and sold in 24 instalments
price [price] 0 EUR
installment [instalment] 24:10 EUR
subscription_cost [subscription_cost] month:24:10.00 EUR
google_product_category [google_product_category] Electronics > Computers > Tablet Computers

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

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

 

Product Google Nexus 9
title [title] Google Nexus 9 – 32 GB – Black – 24 monthly instalments
price [price] 1800 BRL
installment [instalment] 24:10 BRL
subscription_cost [subscription_cost] (Must be empty because there is no service contract)
google_product_category [google_product_category] Electronics > Computers > Tablet Computers
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue