Manage vehicle fitment on eBay and Amazon

Learn how to read, edit, and sync the vehicle compatibility list on your eBay Motors and Amazon parts listings.

Listing Mirror reads the vehicle list a marketplace already holds for a parts listing, shows it on the listing, and — once you take it over — sends your version back on the next sync. You can edit one vehicle at a time, paste or upload a list in bulk, or build one named list and attach it to as many listings as you like.

Where to find it

1. Go to Manage Listings and find the product.
2. In the grid, click the status icon in the eBay or Amazon column to open that marketplace's listing.
3. Scroll down to the Parts Compatibility section. The number beside the heading is how many vehicles the list holds.

The section only appears when the marketplace accepts a vehicle list for that listing's category or product type. If you do not see it, the category does not take one — see What Amazon accepts below, which is the most common reason on Amazon.

Before you can edit: the list has to be read first

Listing Mirror will not let you edit a list it has never read from the marketplace. An empty panel on an unread listing would look like "no vehicles" when the marketplace may hold hundreds, and saving it would wipe them.

Until the read happens you will see:

Nothing is required of you. A background job works through your existing parts listings on both channels and reads each one, and any listing you edit or refresh is read as part of that. Large catalogs are read in batches over several hours so the work never competes with your listing and inventory sync.

Who owns the list

The line under the heading tells you which of two states the listing is in:

• Imported from the marketplace. The marketplace owns the list and Listing Mirror is only showing it. Nothing is sent.
• Managed here and sent to the marketplace on the next sync. You own the list. Your version replaces theirs from then on.

The first edit you save moves the listing from the first state to the second. There is no separate button — editing is taking it over.

Edit vehicles on eBay

eBay describes a vehicle by named aspects — on the US site that is Year, Make, Model, Trim and Engine, and other categories and sites spell them their own way. Each column is a dropdown that narrows as you fill in the one before it, straight from eBay's own vehicle catalog, so you can only pick a combination eBay recognizes.

1. Click Add vehicle to append an empty row.
2. Work left to right across the row's dropdowns.
3. Add anything you want shown alongside that vehicle in the Notes column.
4. Use the trash icon at the end of a row to remove it.
5. Save the listing. The list goes out on the next sync.

A Vehicle ID column appears when eBay has matched a row to a catalog vehicle (its ePID). It is shown for reference and is not editable here.

If the category caps how many vehicles it will take, the panel says so in red and will not save until you are back under the cap.

Edit vehicles on Amazon

Amazon does not describe a vehicle — it names one from a European parts catalog by code. The panel changes shape to match:

• Vehicle Fitment Code — one code per row. A code may not contain a comma or a slash; Amazon reads either as the start of another vehicle.
• Vehicle Fitment Standard — kba, ktype or tecdoc, chosen once for the whole list. Amazon stores one standard per listing, not one per vehicle.
• Vehicle Fitment Note — one note for the whole list, for the same reason.

What you send is stored against your offer. It does not change the shared Amazon product page.

Build a list in bulk

Two buttons sit under the table when you own the list.

Paste a list

• eBay: one vehicle per line, values separated by tabs or commas, in the same order as the columns.
• Amazon: one vehicle fitment code per line.

The button tells you how many vehicles it is about to add before you click it.

Upload a file

A CSV with a header row. The first column decides what the file does:

• Start with Set Name to build shared lists (see below).
• Start with SKU to load vehicles onto listings one SKU at a time.

The remaining columns describe the vehicle: Code and Standard on Amazon, or the category's own aspect names on eBay — spelled exactly the way the category spells them. Notes is also recognised.

Rows that cannot be stored are skipped and named, one line each, rather than failing the whole file — so a single bad code does not cost you the upload.

Fitment Sets: one list, many listings

Most parts catalogs reuse the same vehicle list across dozens or hundreds of SKUs. A Fitment Set is that list, named once and attached to as many listings as you want, so a 20,000-part catalog is not edited a listing at a time.

1. Build the set by uploading a CSV whose first column is Set Name. Every row with the same set name lands in the same set.
2. Open a listing and pick the set from the Shared list dropdown above the table.
3. Choose This listing only in that dropdown to detach a listing and go back to its own vehicles.

While a set is attached, the table on the listing is read-only — the set is the source of truth. Re-upload a CSV with the same Set Name to replace what the set holds; every listing using it is re-synced to the marketplace automatically.

When someone changes the list on the marketplace

If the marketplace's list stops matching yours, Listing Mirror stops sending compatibility for that listing rather than overwriting the change. The panel shows how many vehicles each side has and asks you to pick one:

• Use the marketplace's list — their version replaces yours, and you carry on managing it from there.
• Keep mine — your version is sent on the next sync and replaces theirs.

Click Show the marketplace's list to see their version in full before you decide. Until you choose, the listing carries a sync message saying the compatibility was not sent and why — the hold does not lift on its own.

Two things eBay will refuse

• Deletions close to the end of a listing. eBay does not accept compatibility deletions within 12 hours of a listing ending, or on a listing with bids. Listing Mirror still sends the additions and tells you on the listing that the removals did not take effect.
• Catalog details plus compatibility. eBay will not accept catalog product details on a listing that carries a compatibility list. When both apply, the compatibility list wins and the listing says the catalog details were not sent.

Using the API

Vehicle fitment is on the public API for both channels:

• GET /api/v3/listings/fitment/{id}/?integrationConfigId=N  — returns whether the listing is managed by you, the shared set it uses if any, and the vehicles.
• PUT /api/v3/listings/fitment/{id}/?integrationConfigId=N  — replaces the list, or attaches a shared set by name.

Each vehicle carries properties  (eBay's aspect names, verbatim), notes , and — on Amazon — productReferenceId  and referenceStandard . The endpoints use your existing Product Read and Product Write API key scopes.

The API answers exactly what the panel shows, holds included: a listing whose list has diverged reports the same state you would see in the browser, and the same two answers resolve it.