> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/vehicle-finder/import-vehicle-data.md).

# Import vehicle data

Upload a spreadsheet mapping vehicles to the products and variants that fit them, so the Vehicle Finder form can match shoppers to the right products.

## What this does

The Vehicle Finder form only knows which products fit which vehicles because of the data you import here — without it, the form has nothing to match against, no matter how well it's configured. For example, a spreadsheet row mapping "2019 Honda Civic" to product "Brake Pad Set - Front" is what lets a shopper who selects 2019 / Honda / Civic in the form see that brake pad set (and only vehicle-compatible products) in their results, instead of your full unfiltered catalog.

Each import is additive by default: re-uploading a file with new or updated vehicle mappings adds to what's already on your products without wiping out vehicle data that was already there, so you can grow or correct your fitment data incrementally as your catalog changes.

## Prerequisites

* [Vehicle Finder form](/vehicle-finder/set-up-vehicle-finder-form.md) is set up.

You can also drive fitment from **product metafields** (parallel `custom.vehicles_*` lists). That workflow is still supported — see [Configure YMM metafield values](/vehicle-finder/configure-ymm-metafield-values.md).

## Steps

1. In the app, go to **Vehicle Finder**.
2. Click **Download sample** to get a template file, showing the expected columns (product or variant identifiers alongside Year, Make, and Model).
3. Fill in your vehicle data based on the sample. You can also upload a TecDoc-style sheet (for example `Marke`, `Modell`, `Motor`, `Jahr ab`) — those headers map to Make, Model, Engine, and Year. **Product Ids** may be Shopify product ids, variant ids, or SKUs. Put **one id per row** (repeat the vehicle), or list several in one cell — each on its own line, or separated by `~`.
4. Click **Upload vehicle data file** and select your completed file.
5. Click **Upload & import**.

![Vehicle Finder — upload vehicle data file modal](https://2009335375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmtdB4I84W3J8hc91H4S%2Fuploads%2Fgit-blob-bf4ece5466a7d3230809e7d08faa8d5ac0bbc9b2%2Fymm-upload-modal.png?alt=media)

The app imports the vehicles in the background and adds them to the matching products and variants. Existing vehicle data already on those products is kept, not overwritten.

## Update or remove vehicle data

Once a file has been imported, the Vehicle Finder page shows its file name, size, and last updated time, with actions to:

* **Download** the currently imported file.
* **Re-import** after making changes to your spreadsheet.
* **Delete** all imported vehicle data.

## Product metafield (combined) — optional

You can also store multiple fitment rows in **one product or variant metafield** as JSON. This is an **extra** option alongside:

* Parallel `custom.vehicles_*` lists — [Configure YMM metafield values](/vehicle-finder/configure-ymm-metafield-values.md)
* Spreadsheet import on this page

It does not replace those methods. When several sources exist on the same product, the app merges and deduplicates fitment rows.

### Supported metafield keys

Any namespace, with one of these keys (case-insensitive): `vehicles`, `vehicle_fitments`, `ymm`, `ymm_vehicles`, `fitments`.

Example: `custom.vehicles`.

### JSON

Metafield type **JSON** (or multi-line text containing a JSON array of objects). Keys on each object become vehicle attributes (dynamic — not limited to year/make/model):

```json
[
  {"year":"2025","make":"Toyota","model":"Camry"},
  {"year":"2025","make":"Toyota","model":"Vios","engine":"1.5"}
]
```

After you save the metafield in Shopify, re-sync products (or wait for the product update webhook) so Vehicle Finder can use the new rows.

## Related pages

* [Set up Vehicle Finder form](/vehicle-finder/set-up-vehicle-finder-form.md)
* [Configure Vehicle Finder fields](/vehicle-finder/configure-vehicle-finder-fields.md)