# Configure YMM metafield values

✨If you're using **metafields** as the data source for your Year – Make – Model (YMM) search form, it's important to format the metafield values correctly so the dropdowns work as expected.

This guide will walk you through exactly how to structure those values.

***

### ⚡️1. Rule to define product metafields

You should create a product metafield based on the below rules:

* Metafield's namespace is **custom**
* Metafield's key has to start with **vehicles\_**

> Example:\
> product.metafields.<mark style="color:red;">**custom.vehicles\_**</mark>year \
> product.metafields.<mark style="color:red;">**custom.vehicles\_**</mark>make \
> product.metafields.<mark style="color:red;">**custom.vehicles\_**</mark>model

* Use a **List of values** instead of **one value**

<figure><img src="https://2009335375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmtdB4I84W3J8hc91H4S%2Fuploads%2FRERtvMTztX0tk6sYTCkF%2Fimage.png?alt=media&#x26;token=c370632d-1d2f-4068-bdc4-14f38cd715f7" alt=""><figcaption></figcaption></figure>

***

### ⚡️2. Why is the above rule important?

When using metafields for your YMM form, the values in your product metafields determine what options appear in the dropdowns. The app reads this information to create links between the fields, for example, to show the correct Model and Year options after a Make is selected.

***

### ⚡️3. Where to add these product metafield values?

Each product’s metafield data set must include the **full combination of Year, Make, and Model.**

#### ✅ Example:

* `2020|Toyota|Camry`
* `2021|Toyota|Camry`
* `2021|Toyota|Corolla`

You’ll need to add the values above to the metafield field you’re using for YMM.&#x20;

<figure><img src="https://2009335375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmtdB4I84W3J8hc91H4S%2Fuploads%2FAcsnx6BrOWFlfUYzUcQi%2F2025-04-24_12-06-57.png?alt=media&#x26;token=68675c49-4c33-40c6-a5bf-11d4f56ab914" alt=""><figcaption></figcaption></figure>

***

### ⚡️4. Video instructions

<https://www.youtube.com/watch?v=TCrQuF6n2zw&t=13s>

***

### ⚡️5. Tips

* Be consistent with spacing and spelling — e.g., `Toyota` is not the same as `toyota`.
* Make sure every product that should appear in the YMM search has these metafield values added.
* Use the same metafield definition and format across all relevant products.

***

### 🎉  You’re Done!

Once you’ve added these values to your products, your YMM filter will automatically show the correct Model and Year options based on the selected Make.

***

## 💬 Need Help?

Not sure how to define your metafields or can’t find the right setting? Reach out to us at **<contact@globosoftware.net>** — we’re here to assist you.
