[headline_offer_installment]
attribute aren’t eligible for cross-border trade and can have only one targeted country.Use the headline_offer_installment [headline_offer_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
The headline_offer_installment [headline_offer_installment]
attribute will account for a purchase financing or lease option for your product including a down payment and recurring monthly installment payments. The headline_offer_price [headline_offer_price]
attribute will be treated as the full cash price.
The attribute is available for showing wireless products and services only, such as 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 attribute is available for showing wireless products and services in the following countries:
- Europe: Austria, Belgium, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, Ireland, Italy, Norway, Poland, Portugal, Romania, Slovakia, Spain, Sweden, Switzerland, United Kingdom
Costs associated with a wireless subscription plan can also be added using the headline_offer_subscription_cost [headline_offer_subscription_cost]
attribute in these countries.
This attribute uses 3 sub-attributes:
- Months
[months]
(Required): Integer, the number of installments the buyer pays. - Amount
[amount]
(Required): ISO 4217, the amount the buyer pays per month. - Down payment
[downpayment]
(Optional): ISO 4217, the amount the buyer pays upfront as a one-time payment.- Note: The default option for this sub-attribute will be 0 or “No down payment”.
Format
Follow these formatting guidelines to make sure Google understands the data you're submitting.
Learn more about When and how to submit values in English.
Type | Number plus currency |
---|---|
Repeated field | No |
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 headline_offer_price
[headline_offer_price]
attribute. - Use in approved countries only. Use of the headline_offer_installment
[headline_offer_installment]
attribute in unapproved countries will result in disapproval of your product. - Use for approved product categories only. Use of the headline_offer_installment
[headline_offer_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 the submitted value will be rounded.
- If your product is combined with a subscription cost plan, submit the same number of months for the headline_offer_subscription cost
[headline_offer_subscription_cost]
attribute as for the headline_offer_installment[headline_offer_installment]
attribute.- If the number of months is different and your installment payment and subscription cost amounts need to be combined due to space constraints, then the highest of the 2 values is used.
- For example, if your installment plan is 12 months but your subscription service contract is 24 months, the 24 month installment plan will be used.
- Note: The headline_offer_subscription cost
[headline_offer_subscription_cost]
attribute isn't supported in all countries.
- If the installment amount for your product in the headline offer increases after a certain period of time, 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, specify 40 USD.
Examples
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.
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) |
Headline offer price[headline_offer_price] |
900 USD (full payment at checkout) |
Headline_offer_installment [headline_offer_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) |
Headline_offer_price [headline_offer_price] |
300 EUR |
Headline_offer_installment [headline_offer_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
Submit the full up-front payment price for the device in the headline_offer_price [headline_offer_price]
attribute as well as an installment option (with a down payment as low as 0) in the headline_offer_installment [headline_offer_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.
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) |
Headline_offer_price [headline_offer_price] |
221 EUR |
Headline_offer_installment [headline_offer_installment] |
12:18 EUR:5 EUR |
Headline_offer_subscription_cost [headline_offer_subscription_cost] |
month:12:10.00 EUR |
Google product category [google_product_category] |
Electronics > Communications > Telephony > Mobile Phones |