# Feed setup

> [!NOTE]
> **Note:** The following steps are for partners who already signed up for vehicle listings.

> [!NOTE]
> **Note:** The audience for this site is car dealerships, or for a representative of a car dealership, that wants to provide vehicle inventory to Google. If you instead want to advertise your vehicles on Google, see [Vehicle Ads](https://support.google.com/merchants/topic/15174524).

The feed is the central data source that Google uses to access and display your
vehicles. We currently support feeds in the
[CSV file format](https://datatracker.ietf.org/doc/html/rfc4180),
which you can optionally compress with the ZIP or GZ formats.

## Create a feed

To format your information for the vehicle listings service, use the format
described in [Feed format](https://developers.google.com/vehicle-listings/integration-process/feed-setup#feed-format), the attributes provided in
[Feed specification](https://developers.google.com/vehicle-listings/reference/feed-specification), and our
[example feed](https://developers.google.com/vehicle-listings/integration-process/feed-setup#example-feed). We recommend that you start with a few test
vehicles and submit a sample CSV file to the
[validation tool](https://www.google.com/local/cars/tools/feed-validation) to
validate your feed format. You can later scale to include all of your inventory
on Google.

Be sure to include the following details in the feed so that we can accurately
match vehicles with car dealerships on Google:

- **Required:** Store code
  - For details, see [Dealership
    matching](https://developers.google.com/vehicle-listings/integration-process/dealer-matching).
- **Required:** Dealership name and postal address
- **Recommended:** Google Place ID or Maps URL
  - These uniquely identify the dealership's Business Profile on Google and remove any ambiguity compared to matches that use the name and postal address.

### Feed format

Upload your feed as either a Comma-Separated Values (CSV) or Tab-Separated
Values (TSV) file. Make sure your file meets the following requirements:

- The CSV format must conform to [RFC 4180](https://tools.ietf.org/html/rfc4180):
  - Don't include double quotes anywhere in the file unless they're escaped.
    - To escape a double quote, use two double quotes and additionally enclose the entire CSV field in double quotes. For more details, see sections 2.5-2.7 in [RFC 4180](https://tools.ietf.org/html/rfc4180).
    - An example of a valid use of double quotes is `"Wheels 17"" Alloy"`, which displays as `Wheels 17" Alloy`.
- You can optionally compress the file with the ZIP or GZ file formats.
- The feed must contain a single file. We don't support the use of multiple file fragments, also called sharding.
- Every feed version must contain the entire inventory for all dealerships you want to show on Google. Because each feed file contains inventory for all your dealerships, you don't need to create separate accounts for each dealership. Once the feed is successfully processed, the vehicles will be grouped by dealership in the diagnostics page of the partner portal.
- We don't support partial (incremental) inventory updates.

### Example feed

The following example CSV feed can be used as a template for your feeds:

    store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
    123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"

## Upload the feed to your SFTP dropbox

When you sign up for your vehicle listings account, an SFTP dropbox is
automatically created. Use the SFTP information provided on the **Feed** page of
the partner portal to upload your CSV files.

There are many methods to
[upload a file with SFTP](https://www.google.com/search?q=upload+to+sftp). The
most common ways are using the command line (Terminal), or using an
[SFTP program](https://www.google.com/search?q=SFTP+clients). Which method
works best for you depends on how you manage your inventory. As such, we don't
give specific instructions here on how to export and upload your vehicles to
the Google SFTP server.

To minimize delays from how Google processes your feed, we recommend that you do
the following:

- Ensure that your feed passes our [validation tool](https://www.google.com/local/cars/tools/feed-validation).
- Verify that your vehicle data conforms to the [feed specification](https://developers.google.com/vehicle-listings/reference/feed-specification) and our [policies and restrictions](https://developers.google.com/vehicle-listings/reference/policy).
- Submit the feed at least once every day.
- Upload the entire inventory for each dealership you want to show on Google.

## Review feed processing results

After you submit the feed, you can review the results of the processing. The
**Feed** page on the partner portal shows the status of each feed upload. This
only checks for basic file and data issues, such as missing required fields or
incorrect formatting. The full results of processing become available on the
**Diagnostics** page after a few hours.

> [!NOTE]
> **Note:** If you are uploading your feed for the first time or after a long gap (e.g. more than 3 days), expect a delay of about 24-48 hours for the vehicles to appear on your Google Business profile.

## Maintain your feed

We recommend that you upload the latest version of the feed every four hours.
There are two main reasons why we recommend that you refresh the feed this
often:

- More frequent feed uploads increase the overall data freshness. This reduces the time between when the inventory updates and when the data is delivered to Google.
- Frequent updates allow for faster detection of and recovery from outages that could cause a feed to not be successfully processed.

Every time you upload the feed, be sure it contains the entire inventory for all
dealerships. Vehicles and dealerships that aren't present in a feed are removed
from Google within a few hours.

> [!NOTE]
> **Note:** If a feed upload would reduce the total inventory by more than 30% compared to the previous version, a safety mechanism prevents this feed version from being processed. You can adjust when this safety feature triggers in the **Feed** page of the partner portal.

After you upload a feed to Google, the time it takes for the data to update
depends on the type of update. The numbers in the following table are estimates
and not guaranteed.

> [!NOTE]
> **Note:** The partner portal updates several hours faster than the data on Google. If the inventory status on the portal doesn't reflect the content on Google, make sure you allow enough time for the data to update.

| Feed change | Expected update time on Google |
|---|---|
| Add a new dealership | 1 day |
| Remove a dealership | 6 hours |
| Change the Business Profile for a dealership | 12 hours |
| Add, remove, or update a car | 6 hours |

## Subscribe to feed alerts

You can receive an email notification when Google either hasn't received a feed,
or the feed wasn't successfully processed for more than 24 hours. Go to the
**Account** page on the partner portal and add a new contact email you wish to
receive these feed alerts.

> [!WARNING]
> **Warning:** Your vehicles stop showing to users after three days from the time Google last received and successfully processed the feed. Please resolve feed issues as soon as possible to keep showing vehicles to users.