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.custom.vehicles_year product.metafields.custom.vehicles_make product.metafields.custom.vehicles_model

• Use a List of values instead of one value

---

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.

---

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 [email protected] — we’re here to assist you.