> 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/configure-ymm-metafield-values.md).

# Configure YMM metafield values

Format product metafields (custom.vehicles\_\*) as list values so the Vehicle Finder Year, Make, and Model dropdowns link correctly.

## What this does

Drives Vehicle Finder fitment data from product metafields instead of (or alongside) a spreadsheet import — useful if your product data pipeline already writes vehicle compatibility to metafields and you'd rather not maintain a separate spreadsheet. This guide covers the **parallel list metafields** approach (`custom.vehicles_*`), which remains fully supported for existing shops. For an alternative single-metafield JSON format, see [Import vehicle data](/vehicle-finder/import-vehicle-data.md#product-metafield-combined--optional).

The app links Year, Make, and Model together by matching **list index**, not by value — so getting the index alignment right on every product is what makes the dropdowns show the correct Model and Year options after a shopper picks a Make.

## Steps

1. On each product, create metafields with namespace **custom** and keys starting with **vehicles\_** — specifically:
   * `product.metafields.custom.vehicles_year`
   * `product.metafields.custom.vehicles_make`
   * `product.metafields.custom.vehicles_model`
2. Set each metafield to a **list of values**, not a single value.
3. Add the product's full set of Year/Make/Model combinations, keeping the same index aligned across all three lists. For example, a product fitting 2020 Toyota Camry, 2021 Toyota Camry, and 2021 Toyota Corolla needs:

   | Index | `vehicles_year` | `vehicles_make` | `vehicles_model` |
   | ----- | --------------- | --------------- | ---------------- |
   | 0     | 2020            | Toyota          | Camry            |
   | 1     | 2021            | Toyota          | Camry            |
   | 2     | 2021            | Toyota          | Corolla          |
4. After saving metafields in Shopify, re-sync products (or wait for the product update webhook) so Vehicle Finder can use the new values.

## Tips

* Be consistent with spacing and spelling — "Toyota" is not the same value as "toyota".
* Every product that should appear in Vehicle Finder needs these metafield values set.
* Use the same metafield definitions and format across all relevant products.

## 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)
* [Import vehicle data](/vehicle-finder/import-vehicle-data.md) (spreadsheet + optional combined JSON metafield)
