Upload Listings

Listing used vehicles on Facebook Marketplace is currently a beta program. Please contact your Facebook representative for access.

To list your used vehicles, you can:

Learn more about Marketplace Listings on Dealership Pages.

Create a New Vehicles Catalog

To set up a new vehicles catalog:

  1. You need a product catalog and a feed of your inventory hosted at a location of your choice.

  2. Your catalog is a structured data file with a list of cars to showcase on Marketplace. Each line of the file contains all information needed to create a Marketplace listing.

  3. From your Business Manager or Catalog Manager, select Auto > Vehicles, and then click Next to create your catalog.

Assign Your Catalog to a Business Manager

To publish your catalog on Marketplace, you need to assign your catalog to a Business Manager using one of the following options:

You'll need to go to Catalog Manager or Commerce Manager to add and manage items in your catalog.

Learn more about how to create a catalog in your Business Manager.

Add Vehicles to Your Catalog

To upload a new data feed file to a catalog:

  1. In Catalog Manager, select Data Sources.
  2. Select Add Vehicles.
  3. Click Use Bulk Upload > Next.
  4. Choose between Scheduled Feed and Google Sheets. See Add and Manage Catalog Items with Google Sheets.

Add and Manage Catalog Items with Google Sheets

You can use Google Sheets to upload and manage your items in a catalog:

  1. Enter your inventory information in a Google spreadsheet and provide the link.
  2. Keep your spreadsheet up to date on Google and we’ll fetch information from it to update your catalog at scheduled times. Learn more.

We suggest using this upload method if your catalog size is limited (less than 100 vehicles), and not updated frequently (less than once per day).

Learn More

Schedule an Upload

One of the most used methods to populate your catalog is to create a data source endpoint; for example, via FTP or HTTPS.

While setting up your data feed:

  1. Select Scheduled Feed.
  2. Enter the URI where your file is hosted; for example, https://www.mysite.com/feedname.csv.
  3. Optional. Enter username and password, if needed.

For Marketplace, we recommend a daily upload at a time that is most convenient for you.


Choose a Feed Format and Specify Supported Fields

Supported Feed Formats

Feed Format Description & Guidelines Sample Feed

CSV

Comma-separated value.

  • The first row specifies the column header. Subsequent rows supply the corresponding values for each route.

  • Fields containing whitespace or commas should be enclosed in "double quotes". A double quote inside a double-quoted field must be escaped with two consecutive double quotes.

  • Nested or multi-value fields, such as image, can be represented using JSON-encoded values or by a set of "flattened" plain-text columns labeled using JSON-path syntax. Example: (image[0].url, image[0].tag[0], image[0].tag[1])

  • Both conventions can be used interchangeably in the same file.

Download > Right-click > Save Link As

TSV

Tab-separated value. See guidelines for CSV.

Download > Right-click > Save Link As

XML

Format typically generated by automated feed provider systems or web servers. A set of item XML nodes represents a product list and must begin with the <?xml declaration tag.

Download > Right-click > Save Link As

Feed CSV/TSV Example

"vehicle_id","vehicle_registration_plate","vin","make","model","year","transmission","body_style","fuel_type","drivetrain","description","image[0].url", "image[1].url","image[2].url","mileage.value","mileage.unit","url","title","price","state_of_vehicle","exterior_color","address","latitude","longitude","trim","interior_colour","dealer_id","dealer_name","postal_code","dealer_phone","fb_page_id","dealer_communication_channel","dealer_privacy_policy_url"
"56345636","AB12CDE","YV1DZ8256F2693747","Volvo","XC60","2014","AUTOMATIC","OTHER","DIESEL","OTHER","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","http://website.com/images/stock/car1.jpg","http://website.com/images/stock/car2.jpg","http://website.com/images/stock/car3.jpg","12950","MI","http://www.dealership.co.uk","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","22495.00 GBP","Used","White","{""addr1"":""Sample Road"",""city"":""London"",""region"":""Greater London"",""postal_code"":""SW31 3EW"",""country"":""United Kingdom""}","52.7445867","-2.7337375","2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","Black","436456435347346","Dealer Group","SSW31 3EW","","3562564376375","CHAT","https://www.dealership.co.uk/site/privacy-and-legal/"
  

Address Example for CSV/TSV

"{addr1: '1 Hacker Way', city: 'Menlo Park', region: 'CA', postal_code: '94025', country: 'US'}"

Feed XML Example

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <title>Sample Vehicles Feed</title>
  <link rel="self" href="https://www.example.com/dealers/cars/1234/?r=vddn" />
  <listing>
    <vehicle_id>3456553</vehicle_id>
    <title>Ford B-MAX ZETEC</title>
    <description>Adjustable Steering Column, Adjustable Steering Wheel, Air Bags, Air Conditioning, Alloy Wheels, Anti Lock Brakes, Bluetooth Preparation (Phone), CD Player, CD Radio, Driver Airbag, Electric & Heated Door Mirrors, Electric Windows, Electronic Stability Programme (ESP), Front Electric Windows, Front Fog Lights, Height Adjustable Drivers Seat, Passenger Airbag, Power Assisted Steering (PAS), Power Fold &amp; Heated DoorMirrors, Rear Parking Sensor, Remote Boot Release, Remote Central Locking, Solid Paint,LOW MILEAGE WITH A FULL FORD HISTORY, SUPPLIED FROM US,</description>
    <url>https://www.example.com/car-1234>
    <make>Ford</make>
    <image>
      <url>https://www.example.com/1234/image_1.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_2.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_3.jpg</url>
    </image>
    <model>B-MAX</model>
    <year>2015</year>
    <mileage>
      <value>15617</value>
      <unit>MI</unit>
    </mileage>
    <drivetrain>Other</drivetrain>
    <vin>1A2BCDEF3GH456789</vin>
    <body_style>OTHER</body_style>
    <fuel_type>Gasoline</fuel_type>
    <transmission>Manual</transmission>
    <price>9490 GBP</price>
    <address format="simple">
      <component name="addr1">Sample Road</component>
      <component name="city">Carland</component>
      <component name="region">North Test</component>
      <component name="country">United States of America</component>
      <component name="postal_code">12345</component>
    </address>
    <latitude>37.484419</latitude>
    <longitude>-122.148406</longitude>
    <exterior_color>White</exterior_color>
    <state_of_vehicle>Used</state_of_vehicle>
    <features>
      <type>abs_brakes</type>
      <value>ABS</value>
    </features>
    <features>
      <value>Snow tires</value>
    </features>
    <dealer_id>453356</dealer_id>
    <vehicle_registration_plate>AB12CD</vehicle_registration_plate>
    <fb_page_id>5636367576574</fb_page_id>
    <dealer_communication_channel>LEAD_FORM</dealer_communication_channel>
    <dealer_privacy_policy_url>https://www.example.com/privacy/</dealer_privacy_policy_url>
  </listing>
</listings>

Supported Required Fields

NameDescription

vehicle_id

Type: string

Required

Max characters: 100

Unique ID for vehicle. Must be unique in the entire catalog. Can be a variant for a vehicle. If there are multiple instances of the same ID, we ignore all instances. You can also use the VIN for both vehicle_id and vin.

vin

Type: string

Required in all countries, except Brazil, France, Mexico, and United Kingdom

Max characters: 17

Vehicle ID number (VIN) of the vehicle.

Listings with vehicle_type = CAR_TRUCK must have a VIN made by exactly 17 characters. To avoid rejection, set the correct vehicle_type.

VIN is not required for pre 1983 vehicles. Boats have less digits and some vehicles (such as trailers) don't need VINs.

Example: 1FADP5AU6DL536022

vehicle_registration_plate

Type: string

Required in Brazil, France and United Kingdom

The vehicle registration plate number.

title

Type: string

Required

Max characters: 500

Full name of vehicle. This is relevant and specific to each vehicle and it should contain what is set in year, make, model, trim.

Example: 2017 Ford Focus 5DR HD SE

year

Type: integer

Required

Year the vehicle was launched in yyyy format.

Example: 2017

make

Type: string

Required

Make or brand of the vehicle.

Example: Ford

model

Type: string

Required

Model of the vehicle.

Example: Fusion

exterior_color

Type: string

Required

Vehicle exterior color.

Example: Red

body_style

Type: enum

Required

Body style of the vehicle.

Supported values: CONVERTIBLE, COUPE, CROSSOVER, HATCHBACK, MINIVAN, TRUCK, SEDAN, SMALL_CAR, SUV, VAN, WAGON or OTHER.

For cabriolet style, use CONVERTIBLE. For MPV, use MINIVAN. For saloon, use SEDAN. For estate, use WAGON.

drivetrain

Type: enum

Required

Drivetrain of the vehicle.

Supported values: 4X2, 4X4, AWD, FWD, RWD, OTHER.

transmission

Type: enum

Required

Transmission type of the vehicle.

Supported values: AUTOMATIC, MANUAL, OTHER

fuel_type

Type: enum

Required

Supported values: DIESEL, ELECTRIC, GASOLINE, FLEX, HYBRID, OTHER.

mileage.value

Type: integer

Required

For used vehicles, current mileage of the vehicle in kilometers (KM) or miles (MI). For new vehicles, use zero (0).

Vehicles on Marketplace must have over 500 miles/kms.

mileage.unit

Type: string

Required

Mileage units: kilometers (KM) or miles (MI).

description

Type: string

Required

Maximum characters: 5000

Short text describing the vehicle. Don't include promotional text or any links. Don't enter text in all capital letters. Use line breaks to format your description.
Example: Used 2017 Ford Focus 5DR HD SE in great condition, available now

image

Type: array

Required

Vehicle image. You must provide at least 2 images, up to max 50 images supported by vehicle.

Each image can be up to 4 MB in size and should be 960 x 720 px resolution or higher.

For image field, when using a CSV/TSV file, we support 2 different formats:

  • Use an image header that follows this pattern: image[0].url, image[1].url, etc.

OR

  • Use a JSON flatten string that follows this pattern: "[{url:'https://images.com/1.jpg'},{url:'https://images.com/2.jpg'}]"

state_of_vehicle

Type: enum

Required

Current state of the vehicle: used (Used) or certified pre-owned (CPO). The New option is not supported by Marketplace, but is supported by Automotive Inventory Ads with an on-Facebook destination. Learn more here.

price

Type: string

Required

Cost and currency of the vehicle. Format the price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency.

Example: 32000.00 USD

fb_page_id

Type: integer

Required

Facebook page ID of the customer or dealership.

Note: your product catalog must be added to the allow list by Facebook before you can send us Facebook Page IDs for dealerships. The page must be added to the allow list using the Business Manager before the listing will be ingested.

See Managing Permissions for more details.

dealer_id

Type: string

Required

Maximum characters: 100

Alphanumeric identifier of the dealership.

dealer_name

Type: string

Required

Maximum characters: 100

Name of the dealership.

dealer_phone

Type: string

Required

Phone number of the dealership. Requirements:

  • Must display the Call button on a Marketplace listing.
  • Must be a valid phone number format.
  • Must include the country code.

Examples: +13603453333, 001(360)345-3333

address

Type: object

Required

A complete address for the dealership that must be resolvable to its location.
{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY].

Example: {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} Example:675 El Camino Real, Palo Alto, CA (United States)`

In address, addr1

Type: string

Required

Street address of dealership.
Example: 675 El Camino Real

In address, city

Type: string

Required

City where the dealership is located.
Example: Palo Alto

In address, region

Type: string

Required

State, county, region, or province where the dealership is located.
Example: California

In address, country

Type: string

Required

Country where the dealership is located.

Example: United States

In address, postal_code

Type: string

Required

Postal code for the dealership (outside the U.S. or zip code within the U.S.).

Example: 75008 (Paris, France) or 94025 (Menlo Park)

latitude

Type: float

Required

Latitude of the dealership location.

Example: 37.484100

longitude

Type: float

Required

Longitude of the dealership location.
Example: -122.148252

url

Type: url

Required

Link to the external site where you can view the offer details. This is required by the Catalog, but not used in Marketplace.

Optional Fields

The following fields are optional, but we highly recommend using them to enhance your catalog listing quality. Some fields are specifically required by country laws or only available in specific countries. All of them are optional for non-specified countries.

NameDescription

vehicle_type

Type: string

Optional & Recommended

Type of vehicle. Supported values: BOAT, CAR_TRUCK, COMMERCIAL, MOTORCYCLE, POWERSPORT, RV_CAMPER, TRAILER, or OTHER.

CAR_TRUCK is the default; vehicle_type, if no type is specified.

trim

Type: string

Optional & Recommended

Maximum characters: 50

Trim of the vehicle.

Example: 5DR HB SE

condition

Type: enum

Optional & Recommended

Condition of the vehicle. Supported values: EXCELLENT, GOOD, FAIR, POOR, OTHER.

interior_color

Type: string

Optional & Recommended

Maximum characters: 50

Vehicle interior color.

features

Type: enum

Optional & Recommended in all countries

Vehicle features. Each feature must be listed separately and contain a value (required) as a free-text description of the feature, i.e. ABS.


It can also contain a type (optional); see supported values below:

abs_brakes, adaptive_cruise_control, air_conditioning, alarm, alloy_wheels, armored, aux_audio_input, backup_camera, blind_spot_alert, bluetooth, collision_avoidance, cruise_control, daytime_running_lights, dvd_player, fog_lights, hd_radio, heated_seats, heated_steering_wheel, hid_headlights, hill_start_assist, keyless_entry, keyless_start, lane_keep_assist, leather, led_headlights, moon_roof, mp3, navigation, night_view, panorama_roof, park_assist, power_door_locks, power_liftgate, power_seats, power_steering, power_windows, privacy_glass, rear_spoiler, remote_start, roof_rack, running_boards, satellite_radio, stability_control, surround_view_camera, telematics, third_row_seat, tilt_steering_wheel, tinted_windows, tire_pressure_monitor, tow_package, traction_control, ventilated_seats


CSV Example:

[{"value": "ABS", "type": "abs_brakes"}, {"value": "Snow tires"}]

XML Example:

<features>
  <type>abs_brakes</type>
  <value>ABS</value>
</features>
<features>
  <value>Snow tires</value>
</features>

dealer_communication_channel

Type: enum

Optional

Method with which the dealer can be contacted by the user. Supported values: CHAT or LEAD_FORM.

1) LEAD_FORM is available only outside the U.S. and Canada. 2) If not specified, or where LEAD_FORM is not available, use CHAT as the channel.

dealer_privacy_policy_url

Type: url

Required when dealer communication channel is LEAD_FORM

Link to the privacy URL of the dealer listing the vehicle. This should match the dealer of the Facebook page ID (fb_page_id) above.

tag (image tag)

Type: string

Optional

String that describes the image. There can be multiple tags associated with an image, such as Exterior, Interior, StockImage.

stock_number

Type: string

Optional

Dealership's own designation of the car on their lot. The stock number is a way for the dealer to inventory specific vehicles. The manufacturer specifies the stock_number, in addition to VIN and vehicle_id.

availability

Type: enum

Optional

Vehicle availability. Supported values: available or not available.

We don't show vehicles that are unavailable in the listing.

date_first_on_lot

Type: string

Optional

Date this vehicle first arrived at the dealer lot. Used to indicate the inventory age. Use the yyyy-mm-dd format.

Example: 2018-09-05

dealer_url

Type: url

Optional

URL of the dealer listing the vehicle (not the aggregator).

carfax_dealership_id

Type: string

Optional

Dealership ID agreed between Carfax and a customer, enabling the dealer to show Carfax reports.

msrp

Type: string

Optional (U.S. only)

New vehicles only: Manufacturer's suggested retail price of vehicle and currency. Format the price as the cost, followed by the ISO 4217 currency code, with a space between cost and currency.

Example: 32000.00 USD

chrome_id

Type: integer

Optional (U.S. only)

Similar to autodata_id.

legal_disclosure_impressum_url

Type: string

Required (Germany only)

URL with statement of ownership and authorship (impressum).

vehicle_specifications

Type: array

Optional

Specifications/features of the vehicle.

Supported values:

  • type — Type: string. Optional. Type of specification. Values are case-sensitive. Supported values: CO2_emissions, gas_mileage_city, gas_mileage_highway, gas_mileage_combined, engine_size, horse_power.

  • units — Type: string. Optional. Unit used to express the value of this specification. Example: g/km, l/100km

  • value — Type: string. Optional. Value for this vehicle specification. Example: 5.60

energy_efficiency_class_eu

Type: string

Required (Germany only)

Energy efficiency class of the vehicle. Supported values: A+, A, B, C, D, E, F, G.

Example: A

Publish Your Catalog

To publish your catalog’s vehicle on Marketplace:

  1. You must get approval from the Facebook Support Team. You can contact your Facebook Partner Manager directly or send an email to commerce-partnerships@fb.com and include your Catalog ID in the request.
  2. If you have already had one catalog approved for Marketplace, you can create and publish additional catalogs directly from the Catalog Manager.


  3. From the left side navigation bar, select Sales to access the Marketplace Channel.

  4. Click Enable Previews to enable your catalog for Marketplace in test mode.
  5. Click Publish Catalog to publish your catalog in Marketplace.

Full Error Reporting / Catalog Debugging

There is an API that allows you to download the full report of your catalog errors. Check the question "How can I see the full error list of my catalog?" in our FAQ list for more details.

Contact Us

Contact Facebook's Support team for questions.