Headline_offer_installment [headline_offer_installment]

Note: Products with the headline_offer_installment [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 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.

Note: To ensure that this product data attribute gets recognized by our system correctly, remember to submit your data feed file in a format that we support.

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.

An illustration with 3 different colors of one mobile phone

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.

An illustration with 3 different colors of one mobile phone

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

Was this helpful?

How can we improve it?

Need more help?

Try these next steps:

Search
Clear search
Close search
Google apps
Main menu
15124948098687039021
true
Search Help Center
true
true
true
true
true
5172632
false
false