Instalment [installment]

Note: Products with the instalment [installment] attribute are not eligible for cross-border trade, and can have only one targeted country.
Use the instalment [installment] attribute to tell customers the details of a monthly instalment 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 customers if there is a monthly instalment 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 [price] attribute to specify the minimum total cost ('minimum quantifiable price') of the device, including down payment, instalment payments and wireless subscription plan. Use the title [title] attribute to indicate that the device is payable in instalments.
Outside Latin America: 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 instalment [installment] 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.

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)
Latin American countries only: Instalment payment plans are supported for all product categories. An offer that uses the instalment [installment] attribute is 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 instalment attribute to indicate alternative instalment payments and frequency.

This attribute uses two 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 Google understands the data that you're submitting.

For details on when and how to submit values in English, learn more about submitting your product data

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

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


6:50 BRL
XML feeds

<g:installment>

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

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

</g:installment>

To format your data for Content API, have a look at the Content API for Shopping.

Guidelines

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

Minimum requirements

These are the requirements that 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 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 in order to choose the instalment option that you submit.
  • Avoid using the instalment attribute for software subscriptions. Software subscriptions must be prepaid, and submit the yearly prepaid cost using the price [price] attribute.
  • Activation fees should not be included 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 instalment [installment] attribute in unapproved countries will result in disapproval of your product.
  • Use for approved product categories only. Use of the instalment [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 optimise your product data for performance.

  • Submit exact values for your instalment costs in accordance with ISO 4217. For example, submit MXN 1.01 instead of MXN 1.0012, 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 instalment [installment] attribute. If the number of months is different and we need to combine your instalment payment and subscription cost amounts due to space constraints, then we shall use the highest of the two values. For example, if your instalment plan is 12 months, but your subscription contract is 24, then we will use 24 months.
    Note: The subscription cost attribute is not supported in all countries.
  • If the instalment 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 instalment amount increases from 20 USD to 40 USD after six months, then specify 40 USD.

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 Value
ID [id] 9876-S-GRN
Title [title] Android T-shirt – Green – Small
Price [price] 30 MXN
Instalment [installment] 3:10 MXN
Colour [color] Green
Size [size] S
ID [id] 9876-S-GRN
Item group ID [item_group_id] 9876

 

Product data for blue Android T-shirt
Attribute Value
ID [id] 9876-S-GRN
Title [title] Android T-shirt – Blue – Small
Price [price] 30 MXN
Instalment [installment] 3:10 MXN
Colour [color] Blue
Size [size] S
Item group ID [item_group_id] 9876

 

Product data for yellow Android T-shirt
Attribute Value
ID [id] 9876-S-GRN
Title [title] Android T-shirt – Yellow – Small
Price [price] 30 MXN
Instalment [installment] 3:10 MXN
Colour [color] 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 data for a Midnight Blue Google Nexus 6 – 32 GB priced at 36.95 USD, with instalment payment options
Attribute Value
Title [title] Google Nexus 6 – 32 GB – Midnight Blue – (with 24 monthly payments)
Price [price] 36.95 USD (up-front payment at checkout)
Instalment [installment] 24:29.95 USD
Google product category [google_product_category] Electronics > Communications > Telephony > Mobile Phones

 

Product data for a black Google Nexus 9 – 32 GB priced at 0.00 EUR, with instalment payment options
Attribute Value
Title [title] Google Nexus 9 – 32 GB – Black – (with 12 monthly payments)
Price [price] 0 EUR
Instalment [installment] 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-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 instalment payments. Learn more about the price attribute.
Note: The subscription cost [subscription_cost] is not available in the US or Latin America.
An illustration with 3 different colors of one mobile phone

 

Product data for a Midnight Blue Google Nexus 6 – 32 GB priced at 40.00 EUR, with instalment payment options
Attribute Value
Title [title] Google Nexus 6 – 32 GB – Midnight Blue – (with contract, 12 instalment payments)
Price [price] 40 EUR
Instalment [installment] 12:18 EUR
Subscription cost [subscription_cost] month:12:10.00 EUR
Google product category [google_product_category] Electronics > Communications > Telephony > Mobile Phones

 

 

Product data for a black Google Nexus 9 – 32 GB priced at 0.00 EUR, with instalment payment options
Attribute Value
Title [title] Google Nexus 9 – 32 GB – Black – (with contract, 24 instalment payments)
Price [price] 0 EUR
Instalment [installment] 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 instalment [installment] attribute.
An illustration with 3 different colors of one mobile phone

 

Product data for a Midnight Blue Google Nexus 6 – 32 GB priced at 1,080.00 BRL, with instalment payment options
Attribute Value
Title [title] Google Nexus 6 – 32 GB – Midnight Blue
Price [price] 1080 BRL
Instalment [installment] 12:95 BRL
Google product category [google_product_category] Electronics > Communications > Telephony > Mobile Phones

 

 

Product data for a black Google Nexus 9 – 32 GB priced at 1,080.00 BRL, with instalment payment options
Attribute Value
Title [title] Google Nexus 9 – 32 GB – Black
Price [price] 1,080 BRL
Instalment [installment] 24:10 BRL
Google product category [google_product_category] Electronics > Computers > Tablet Computers

 

The subscription cost [subscription_cost] attribute should not be included since there is no service contract.

For more examples, please see the best practices for advertising wireless products and services.

Phone or tablet sold with instalment payments (Australia only)

Submit the total minimum cost of the device including instalment payments in the price [price] attribute. Use the title [title] attribute to specify that your wireless product is sold with an instalment payment plan. Learn more about the price attribute
Attribute 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 instalment [installment] attribute and the subscription cost [subscription_cost] attribute should not be included.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

true
Search
Clear search
Close search
Google apps
Main menu
Search Help Centre
true
71525
false