Vehicle ads installments [installment]

The installment [installment]attribute is used to provide customers with the specifics of a vehicle's monthly payment plan, including financing and leasing options. This attribute allows you to display a monthly cost alongside the full cash price of the vehicle in your ads.

On this page:

👁 Optional
Optional for each product

Vehicle ads: This attribute is currently available for vehicle ads in Canada, France, Germany, Italy, Japan, Netherlands, Spain, United Kingdom, and United States.
Approved categories:
- Globally, this is supported for:
  - Cars, Trucks & Vans (Category 916)
- In the US, additional supported categories include:
  - RVs (920)
  - ATVs (3018)
  - Travel Trailers (4243)

Alert: To ensure your data is processed correctly, the installment [installment] attribute and all its sub-attributes must be submitted in English only.

Follow these formatting guidelines to ensure Google understands the data you’re submitting.

Learn how to

Supported values	`months` `amount` `downpayment` `credit_type` `finance` `lease` `total_amount`
Repeated field (What’s this?)	No

File format

Example value

Text feed

Include the attribute header followed by sub-attributes in parentheses, separated by a colon ( : ).

For example: Installment(months:amount:downpayment:credit_type:apr)

XML (Feeds)

<g:installment>

<g:months>36</g:months>

<g:amount>250.00 USD</g:amount>

<g:downpayment>0.00 USD</g:downpayment>

<g:credit_type>finance</g:credit_type>

<g:apr>2.00</g:apr>

</g:installment>

This attribute uses the following sub-attributes:

Months [months] (Required): This is an integer representing the number of monthly payments.
Amount [amount] (Required): The monthly payment amount. Must follow ISO 4217 currency standards
- For example: 150.00 USD
Annual percentage rate APR [apr](Required in some countries) The APR expressed as a decimal number where 2.00 represents 2%.
Downpayment [downpayment] (Optional): The upfront payment required. Must follow ISO 4217 currency standards. Defaults to 0 if not provided.
Credit type [credit_type] (Optional): The type of installment. This is an ENUM field with supported values: finance or lease. Defaults to finance if unspecified.
Total amount [total_amount] (Optional): The total amount of credit or total amount owed by the consumer, depending on regional requirements. Formatted via ISO 4217.
- Note: This is a required attribute for vehicle ads installment ads in Spain and Italy when the credit type[credit_type] is finance .
  - Spain: Use this to provide the Importe Total Adeudado (Total Amount Owed).
  - Italy: Use this to provide the Importo totale del credito (Total Amount of Credit).
    - Note: For Italy, the value must be stated explicitly and cannot be replaced by a calculation formula.

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

Match your landing page. The installment details in your feed (amount [amount], months [months], downpayment [downpayment]) must match the default "On-load" values displayed on your landing page.
Provide country-specific mandatory data.
- Italy and Spain: You must include total amount[total_amount]when the credit type [credit_type] is finance.
- United States, France, Germany, Italy, Spain and Canada: You must include APR [apr] when the credit type [credit_type]is finance.
- Handle "Lease-Only" offers correctly. If a vehicle is only available for lease and has no cash price, you must set the price [price] attribute to 0.
- Data Integrity: Do not put the monthly installment amount in the standard price [price] field.

Additional guidelines

Review the additional section closely to determine if the requirements apply to your country or product.

Landing page requirements

The vehicle’s landing page must provide complete installment offer details in compliance with local laws. The installment details displayed on the ad format are based on a representative example provided on the landing page and are estimates only.

Market-specific requirements for Vehicle ads

Requirements for Vehicle Ads. Use of the installment [installment]attribute for vehicle ads for the following countries:

Market	APR `[apr]`	Monthly Amount `[amount]`	Number of Months `[months]`	Total Amount `[total_amount]`
United States	👁 Required Required (When finance is the credit type)	👁 Required Required	👁 Required Required	N/A
France	👁 Required Required (Finance and Lease* credit type)	👁 Required Required	👁 Required Required	N/A
Germany	👁 Required Required (When finance is the credit type)	👁 Required Required	👁 Required Required	N/A
Italy	👁 Required Required (When finance is the credit type)	👁 Required Required	👁 Required Required	👁 Required Required (When finance is the credit type)
Spain	👁 Required Required (When Finance is the credit type)	👁 Required Required	👁 Required Required	👁 Required Required (When finance is the credit type
Canada	👁 Required Required (When Finance is the credit type)	👁 Required Required	👁 Required Required	N/A
United Kingdom	👁 Optional Optional	👁 Required Required	👁 Required Required	N/A
Japan	👁 Optional Optional	👁 Required Required	👁 Required Required	N/A
Netherlands	👁 Optional Optional	👁 Required Required	👁 Required Required	N/A

Note: APR for Lease in France becomes mandatory starting November 2026.

Keep in mind: If credit type [credit_type] is not submitted, it will automatically default as finance [finance]. If the down payment [downpayment] is not submitted, it will default as 0.00.

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

Provide a downpayment even if it is zero: Explicitly providing the down payment [downpayment] sub-attribute (for example, 0.00 USD) helps ensure the ad displays the most accurate financial picture to the customer.
Update frequently: Financial terms and APRs change often. Ensure your feed is synced with your website to avoid "Installment mismatch" disapprovals.
Don't use Title for price: Avoid putting the monthly payment amount in the title [title] attribute. Use the dedicated installment [installment] sub-attributes instead to ensure proper formatting in the ad.

Ensure Landing Page Consistency: Installment terms in the feed (amount, down payment, and months) must match the default "on-load" values displayed on the advertiser's landing page.
Credit type [credit_type] is not required for all countries, but it is highly recommended. If the credit type [credit_type]is not submitted, the system will default to “finance".

Vehicle sold with finance-based installments (Spain)

Submit financing details for a vehicle in Spain, including mandatory total amount [total_amount]and APR [apr] for finance offers.

Attribute	Value
`installment (months:amount:downpayment:credit_type:apr:total_amount)`	`72:300.00 EUR:2000.00 EUR:finance:4.5:21600.00 EUR`

Detailed sub-attribute breakdown:

Months [months]: 72
Amount [amount]: 300.00 EUR
Downpayment [downpayment]: 2000.00 EUR
Credit type [credit_type]: finance
APR[apr]: 4.5
Total Amount [total_amount]: 21600.00 EUR

Lease-only vehicle with no cash price (United States)

If the vehicle is only available for lease and has no full cash price, the price [price] attribute must be set to 0.00.

Attribute	Value
`price [price]`	`0.00 USD`
`installment(months:amount:downpayment:credit_type)`	`24:219.72 USD:3086.40 USD:lease`

Detailed sub-attribute breakdown:

Months [months]: 24
Amount [amount]: 219.72 USD
Downpayment [downpayment]: 3086.40 USD
Credit type [credit_type]: lease

Vehicle sold with finance-based installments (Japan)

Submit financing details for a vehicle in Japan, ensuring the mandatory credit type [credit_type] and relevant used vehicle attributes are included.

Attribute	Value
`installment (months:amount:downpayment:credit_type)`	`60:35000 JPY:500000 JPY:finance`
`vehicle_expenses`	`150000 JPY`
`vehicle_mandatory_inspection_included`	`Yes`

Detailed sub-attribute breakdown:

Months [months]: 60
Amount [amount]: 35000 JPY
Downpayment [downpayment]: 500000 JPY
Credit type [credit_type]: finance

For Japan localized feeds, even when targeting Japan, the installment [installment] group attribute and its sub attribute names (For example: months [months], amount [amount]) must be submitted in English only.

Was this helpful?

How can we improve it?

URL: https://support.google.com/google-ads/answer/17035779