How to create a primary feed

Required for build to order vehicle offers only.

Optional or can be omitted for non-build to order offers.

Supported values:

• in_stock
• build_to_order

How to map to Merchant Center values:

• in_stock : InStock, LimitedAvailability, OnlineOnly
• build_to_order : BuildToOrder

Required

Google Product Category.

Supported categories (all VLA supported countries):

• Cars, Trucks & Vans: Vehicles & Parts > Vehicles > Motor Vehicles > Cars, Trucks & Vans (Category code: 916)

Supported categories (US only):

• Recreational Vehicles: Vehicles & Parts > Vehicles > Motor Vehicles > Recreational Vehicles (Category code: 920)
• ATVs and UTVs: Vehicles & Parts > Vehicles > Motor Vehicles > Off-Road and All-Terrain Vehicles > ATVs & UTVs (Category code: 3018)
• Travel Trailers: Vehicles & Parts > Vehicle Parts & Accessories > Vehicle Storage & Cargo > Motor Vehicle Trailers > Travel Trailers (Category code: 4243)

Note: For all other VLA supported countries (except US), only the category code: 916is supported.

Required

This group attribute is used with the store_code sub-attribute for in store fulfillment. Store code isn't required for online offers. Learn more about Vehicle fulfillment [vehicle_fulfillment] .

Supported values:

• in_store
• online

This attribute can be repeated up to 3 times for each offer, allowing dealers to specify an option for each fulfillment type.

Optional

Specific title for the vehicle for sale which is displayed in Merchant Center.

Optional

Use this attribute to include your own product categorization system in your product data.

Required

Optional in some countries and for build to order offers (when your availability [availability] is set to build_to_order ).

Vehicle Identification Number, unique identifier for each car.

If VIN [vin] is optional in your business country, you should submit ID [id] as an alternative vehicle identifier.

Required

Your product’s unique identifier. This can be an internal stock number or VIN.

In the EEA+UK, this identifier should also appear on the vehicle’s landing page.

Required for in-store offers

Unique alphanumeric identifier for each dealership.

Note: The store code attribute is case-sensitive and must match the store codes submitted in your Business Profile.

String

This is a repeated field which can take multiple values.

Required 

Single image of the specific vehicle.

The URL for your main vehicle image.

Learn more about image guidelines for vehicle ads

Optional

Up to 10 additional images of the specific vehicle.

More images for your vehicle beyond the main image provided in the image link attribute, commonly used to show a vehicle from different angles.

This is a repeated field which can take multiple values.

Required for in-store offers

Link to specific vehicle descriptions page (VDP). Make sure to include the {store_code} ValueTrack parameter.

Note: The parameter in the URL should be written using the words “ {store_code} ”. Don’t input the actual store code.

The URL for the landing pages of the vehicle on your site.

Example: including store_code as URL parameter: http://mikemart.com/123?store={store_code}

Example: including store_code as part of URL path: http://acmestores.com/456/store/{store_code}

Required for online offers

Link to specific vehicle descriptions page (VDP).

Optional

Link to specific vehicle descriptions page (VDP) for mobile devices.

Make sure to include the {store_code} ValueTrack parameter.

Note: The parameter in the URL should be written using the words “store_code”. Don’t input the actual store code.

Optional

Link to specific vehicle descriptions page (VDP) for mobile devices.

Optional

Similar to link_template but can include ads tracking parameters.

Link to specific vehicle descriptions page (VDP). Make sure to include the {store_code} ValueTrack parameter.

Required

The selling price to be displayed on the ad.

Make sure this price matches the most prominent or final price on your VDP landing page and complies with local laws with respect to price information.

In the UK, the price must be inclusive of all taxes and non-optional charges actually paid by the consumer (in the local currency).

In the United States, the price should be the actual price for which any consumer can purchase the advertised vehicle, excluding only required government charges and fees.

Number plus currency (use ISO 4217).

Example: 8000.00 USD

Required for new cars in Australia and Canada and Japan and used cars in Australia and Japan.

Optional in some countries

Enum: All-in, Drive-away, and more.

Learn more about the Applicability of the vehicle price type attribute .

Use the [vehicle_price_type] attribute to describe the type of price provided in the price attribute.

Supported values:

• all_in_price
• drive_away_price
• estimated_drive_away_price
• excluding_government_charges_price
• vehicle_base_price

Required for new cars in some countries

Optional for used cars

MSRP (Manufacturer Suggested Retail Price) for the vehicle in its current configuration.

If the MSRP isn't the same as the selling price (above), it should be displayed separately on your VDP landing page as well and labeled as MSRP.

Required for new cars in some countries

Optional for used cars

The all-in advertised price includes costs for the following – any accessories attached to the vehicle, environmental levies, extra warranty, fuel, freight, pre-delivery inspection (PDI), dealer fees for handling licensing, provincial regulatory fees, miscellaneous dealer charges for security etching and nitrogen tire fill, and factory-to-customer or dealer-to-customer discounts or incentives.

This price must appear on the vehicle description page as well.

Note: The all-in advertised price doesn’t include sales tax, licensing (the cost of the plate and registration), any trade-in, or costs associated with vehicle financing.

Learn more about the applicability of the price attribute

Optional

Installment-based pricing for vehicle purchase or lease.

Only available in some countries .

All 4 sub attributes ( months , amount , downpayment , and credit_type ) are required when used with vehicle ads.

The Annual percentage rate [apr] sub-attribute is required for credit_type = finance offers in the United States.

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.

Required

The condition of the vehicle.

Review additional guidelines for mileage considerations related to vehicle condition.

Supported values:

• Used
• New

Optional

Car is OEM certified pre-owned.

Required

The name of the company that manufactured the vehicle.

Required

Model of the car without trim specifics.

(for example, submit “Model” and not “Model deluxe" or “Model standard”)

Optional

Trim of the model.

Required

Optional in some countries

Model year.

Required

Number of miles on the vehicle.

Make sure to include the Unit (km/miles).

Integer + Unit (km/miles)

Example: 43000 KM or 24533 Miles

Required

OEM specified exterior color, text.

Optional for build to order offers.

String

Examples: White, Black, Red, Platinum, Metallic Tri-Coat

Notes:

• You can submit up to 3 colors, separated by “ / “
• If you describe the vehicle on your landing page using a unique color (for example, "Eco green"), submit that value through the color attribute, then add a more standard color name (for example, “Green”) to your title.

Optional

( Required for free vehicle ads)

List of installed options, using comma separators.

(for example, Leatherette Seats, Rear View Camera, Navigation System, Front Seat Heaters, A/C, Sunroof, Bluetooth)

String

The maximum number of values supported is 200. Each value may contain up to 256 characters.

This is a repeated field which can take multiple values.

Optional

Enum: Sedan, SUV, Crossover, and more.

Supported values:

• atv_sport
• atv_touring
• atv_utility
• atv_youth
• city_car
• compact_suv
• convertible
• coupe
• crossover
• full_size_van
• hatchback
• limousine
• minivan
• notchback
• sedan
• side_by_side
• station_wagon
• suv
• truck
• ute
• utv_recreational_utility
• utv_sport
• utv_utility
• utv_youth
• class_a_motorhome
• class_b_motorhome
• class_c_motorhome
• travel_trailer
• fifth_wheel
• pop_up_camper
• truck_camper

Optional

Required in some countries

Enum: Gasoline, Diesel, Electric, Hybrid, and more

Supported values:

• gasoline
• petrol
• diesel
• electric
• hybrid
• lpg
• methane
• natural_gas
• plug-in_hybrid
• other

Optional

Free text. Seller notes and options: free text field for additional information about the car, such as single owner and/or a Separated list of installed options for example, Leatherette Seats, Rear View Camera, Navigation System, Front Seat Heaters, A/C Seat(s), Sunroof(s), Satellite Radio Ready, and more.

Optional

Add up to 5 custom labels.

custom_label_0 through custom_label_4 allow you to create specific filters to use in your Ads campaigns. Use these filters for reporting and bidding on groups of products. The information you include in this attribute won’t be shown to users.

For example, you could label a group of products by make, model, or year.

Learn how to use custom labels for Shopping ads .

String

Example:

• custom_label_0: (vehicle make)
• custom_label_1: (vehicle model)
• custom_label_2: (vehicle year)

Optional

If you want to have your product participate in additional destinations (beyond what you specified in your feed settings), use the included destination [included_destination] attribute.

Learn more about Included destination [included_destination]

Supported values:

• vehicle_ads

Optional

If you want to prevent your product from appearing in certain destinations, use the excluded destination [excluded_destination] attribute.

Learn more about Excluded destination [excluded_destination]

Supported values:

• vehicle_ads

Required for used vehicles in some countries

Optional in other countries

String (YYYY-MM)

Required in some countries for new cars if the engine is gasoline, diesel, hybrid, and plug-in hybrid

The amount of fuel consumed in liters to travel 100 kilometers using the given vehicle.

Use kg/100km for natural gas engines.

Note: The values specified must be measured in the combined test cycle.

Number + unit (l/100km or kg/100km)

Required in some countries

The amount of fuel consumed in liters to travel 100 kilometers using the given vehicle when the battery is discharged.

For example:6.2 l/100km (the unit has lower case ‘L’)

Use kg/100km for natural gas engines.

Required in some countries for new cars. When engine = electric, enter 0 g/km.

The CO2 emissions in g/km for the given vehicle.

Note: The values specified must be measured in the combined test cycle.

Number + unit

Required in some countries for new cars if the engine is plug-in hybrid or electric.

Note: The values specified must be measured in the combined test cycle.

Number + unit

Required in some countries for new cars when engine is plug-in hybrid or electric

Electric range for electric vehicles.

Note: The values specified must be measured in the combined test cycle.

Equivalent All Electric Range (EAER) for plug-in hybrid vehicles in km according to the local regulatory agency.

Int + Unit (KM / MILES)

Example:2333 Miles

Required in Germany for new cars, used cars with less than 1,000 km mileage, or used cars registered within the last 8 months.

The emissions certification for the vehicle (such as BMWK for Germany or ADEME for France).

Emission standard associated with the CO2 emissions value for the vehicle.

Required in Italy for new cars

• euro1
• euro2
• euro3
• euro4
• euro5
• euro5b
• euro6
• euro6c
• euro6d
• euro6d-TEMP
• euro6e
• zero_emissions

Optional

Required in Japan for used vehicles.

Miscellaneous expenses including insurance, registration fees, and more.

Optional in Japan

The vehicle category. This attribute is currently only used in Japan.

Kei Jidosha: Light vehicles engines up to ~660 cc

Futsu sha: Moderate, engines between 660-2000 cc and others that are not classified as Kei Jidosha or Ogata Sha

Ogata sha: Large sized vehicles engine

Supported values:

• kei_jidosha
• futsu_sha
• ogata_sha

Optional and only available in Japan.

When not specified, equivalent to “No warranty”.

Duration: Number (in months)

Mileage: Number (in kilometers)

For warranties with unlimited mileage based on a time frame only, specify the duration in months and leave mileage blank.

Required in Japan for used vehicles

If the vehicle is sold with mandatory inspection and maintenance performed before delivery, in Japan, it’s displayed as "regular inspection maintenance included."