Vehicle listing (Car
) structured data
Vehicle listing structured data allows car dealerships to make their sale vehicle inventory eligible for display on various Google surfaces, including Google Search and dealerships' Business Profiles. People can then search, filter, and easily learn more about vehicles for sale such as availability, pricing, and key information about the vehicles for sale, potentially directing customers to your business.
Feature availability
The vehicle listing rich result is currently only available in English in the US and US territories. The feature is available on both mobile and desktop.
Two ways of providing inventory data to Google
There are two methods for car dealerships to provide their car inventory data to Google. One is through structured data markup on their websites, which is the main focus of this document, and the other is through feed files uploaded to the vehicle listings partner portal. Both methods enable car inventory data to be displayed on Google surfaces.
Here are some characteristics of the two methods:
Method and description | |
---|---|
Structured data markup
|
|
Feed file uploads |
Learn more about how to upload a vehicle listings file feed. |
Feed files would be a suitable option if you are comfortable with creating and maintaining them technically. Structured web markup would be a suitable option if you prioritize ease of implementation. If you choose to use both methods, make sure the data is consistent between feeds and markup. If there are any discrepancies, the feed data will override the conflicting markup data.
How to add structured data
Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.
Here's an overview of how to build, test, and release structured data.
- Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
- Follow the guidelines.
- Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
- Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is
accessible to Google and not blocked by a robots.txt file, the
noindex
tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs. - To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.
Example
Here's an example single vehicle listing page with markup.
<html> <head> <title>1999 Dodge Ram Pickup 2500 ST</title> <script type="application/ld+json">{ "@context": "https://schema.org", "@type": "Car", "name": "1999 Dodge Ram Pickup 2500 ST", "vehicleIdentificationNumber": "1BXKF23ZXXJ000000", "image": [ "https://example.com/image1.png", "https://example.com/image2.png" ], "url": "https://www.example.com/used-vehicle-1999-dodge-ram-pickup-2500-st-c-67/", "offers": { "@type": "Offer", "availability": "https://schema.org/InStock", "price": 10000, "priceCurrency": "USD" }, "itemCondition": "https://schema.org/NewCondition", "brand": { "@type": "Brand", "name": "Dodge" }, "model": "Ram", "vehicleConfiguration": "ST", "vehicleModelDate": "1999", "mileageFromOdometer": { "@type": "QuantitativeValue", "value": "20170", "unitCode": "SMI" }, "color": "White", "vehicleInteriorColor": "Gray", "vehicleInteriorType": "Standard", "bodyType": "Pickup", "driveWheelConfiguration": "https://schema.org/FourWheelDriveConfiguration", "vehicleEngine": { "@type": "EngineSpecification", "fuelType": "Gasoline" }, "vehicleTransmission": "Manual", "numberOfDoors": 2, "vehicleSeatingCapacity": 2 } </script> </head> <body> </body> </html>
Guidelines and eligibility requirements
There are several eligibility requirements for dealerships to display their car inventory data on Google surfaces:
- The dealership must have a claimed and verified Business Profile on Google in the US or US territories. For details, see How to verify your business on Google.
- The Business Profile must have the Place type
vehicle_dealer
. See How to choose a category for your Business Profile. - Only include vehicle inventory for sale directly from the dealership. Vehicles from private sellers, individuals, or auto brokers are not permitted.
- Only include vehicle inventory for cars that are for sale in the US or US territories.
For your page to be eligible for vehicle listings rich results, you must also follow the Search Essentials and General structured data guidelines.
Structured data type definitions
You must include the required properties for your content to be eligible for display in vehicle listing rich results. You can also include the recommended properties to add more information about your content, which could provide a better user experience.
Car
The full definition of Car
is provided on schema.org.
Required properties | |
---|---|
brand
|
Information about the make of the vehicle. |
brand.name
|
The name of the make of the vehicle, such as "Toyota". |
itemCondition
|
The condition of the vehicle, either new or used. Use one of the following values:
|
mileageFromOdometer
|
Information about the total distance traveled by the vehicle since its initial production, as read from its odometer. |
mileageFromOdometer.unitCode
|
The unit of distance given using the UN/CEFACT Common Code (three characters). Use one of the following values:
|
mileageFromOdometer.value
|
The numerical value of distance, as read by the odometer. |
model
|
The model of the vehicle, such as "Civic". Don't include trim specifics like LX or EX. |
offers
|
The offer details about the vehicle that's for sale. |
offers.availability
|
The availability of the vehicle. Use one of the following values:
|
offers.price
|
The final sale price for the vehicle. Vehicle listings must meet our price policies:
|
offers.priceCurrency
|
The currency of the sale price in three-letter ISO 4217 format. |
vehicleIdentificationNumber
|
The Vehicle Identification Number (VIN), which is a unique alphanumeric identifier for each vehicle. The vehicle must have a valid Vehicle Identification Number:
|
vehicleModelDate
|
The model year in the format |
Recommended properties | |
---|---|
bodyType
|
The body style of the vehicle, such as sedan, suv, or crossover.
Currently, Google only supports
|
color
|
The OEM-specified exterior color, such as White, Platinum, or Metallic Tri-Coat. |
driveWheelConfiguration
|
The drive wheel configuration (for example, which roadwheels will receive torque from the vehicle's engine via the drivetrain). Use one of the following values:
|
image
|
The image(s) for the vehicle. The image(s) must meet our image policies and specifications. If you're having issues, see how to fix an invalid image. |
name
|
The name of the vehicle as it's displayed on the website. For example, |
numberOfDoors
|
The number of doors. |
url
|
The link to the dealer's Vehicle Details Page (VDP). |
vehicleConfiguration
|
The trim of the model, such as |
vehicleEngine
|
Information about the vehicle's engine specification. |
vehicleEngine.fuelType
|
The type of fuel that's suitable for the engine of the vehicle. |
vehicleInteriorColor
|
The OEM-specified interior color, such as |
vehicleInteriorType
|
The type or material of the interior of the vehicle (for example, synthetic fabric, leather, wood). While most interior types are characterized by the material used, an interior type can also be based on vehicle usage or target audience. |
vehicleSeatingCapacity
|
The number of seats. |
vehicleTransmission
|
The transmission specification. For example, 9-speed automatic or manual. |
Monitor rich results with Search Console
Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:
- After deploying structured data for the first time
- After releasing new templates or updating your code
- Analyzing traffic periodically
After deploying structured data for the first time
After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:
- Fix the invalid items.
- Inspect a live URL to check if the issue persists.
- Request validation using the status report.
After releasing new templates or updating your code
When you make significant changes to your website, monitor for increases in structured data invalid items.- If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
- If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.
Analyzing traffic periodically
Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.Troubleshooting
If you're having trouble implementing or debugging structured data, here are some resources that may help you.
- If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
- Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
- You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
- If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
- Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
- Troubleshoot missing rich results / drop in total rich results.
- Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
- Post a question in the Google Search Central forum.