✏️ Requires: Make/Model/Year Add-on
After connecting your Auto Integration, you’ll need to configure the Make/Model/Year setup for your store.
Make/Model/Year is the foundation of your catalog and fitment-based search. The setup you choose depends on the Auto Integration you're using and how you want to organize your catalog. If the Make/Model/Year setup doesn’t match your integration’s requirements, vehicle or product imports may fail.
In this section, we’ll help you choose the right Make/Model/Year setup for your integration and explain how to avoid settings that could cause problems.
Before you begin
Connect your Auto Integration with your API Credentials.
What is Make/Model/Year (or MMY)?
Make/Model/Year is the fitment system your store uses to organize vehicles and connect them with compatible parts in your catalog (fitment logic). It powers the “Shop by Vehicle” feature, allowing customers to easily find parts that fit their car.
MMY defines how your store matches vehicle details – like make, model, and year –with auto integration data. You can adjust how vehicles are organized and how fitment is applied by updating the MMY add-on settings, depending on how your data is structured and imported.
Recommended MMY setup
The MMY setup in your store is flexible. Depending on the types of products you sell, you can configure between two and four MMY levels — each with custom names.
For example:
MMY Setup | Description |
| 4 levels, basic MMY setup (default) |
| 4 levels, Trim as a last level name |
| 3 levels, Year is placed on the first level. |
💡 In most cases, it’s best to use the default MMY setup: Make / Model / Year / Submodel. Up next, we’ll explain why this works best for most stores and when you might want to customize it.
Why to keep the default MMY setup?
Most Auto Integrations like ASAP Network, AutoSync, and SEMA Data are built to work with X-Cart’s default MMY setup Make / Model / Year / Submodel.
Changing it can break the connection between vehicles and products, causing missing fitment data or importing items that don’t link to any vehicle.
To avoid these issues, we recommend keeping the default MMY settings if you’re using Auto Integrations.
When to create custom MMY setup?
Consider adjusting the default MMY structure and settings in one of these two cases:
ATD (American Tire Distributor) is your only integration
ATD (American Tire Distributor) is your only integration
In comparison to other integrations, ATD uses Trim instead of Submodel to organize vehicles.
If ATD is your only integration and your main source of product data:
Set your MMY to:
Make / Model / Year / Trim
Import vehicles from ATD as well before importing products.
⚠️ This setup won’t work with other integrations. If you think you'll add more integrations later, it’s better to stick with the default MMY structure.
You're not using any auto integrations
You're not using any auto integrations
If you’re not using auto integrations at all and want to upload your vehicle list and product data yourself via CSV files, you can create any structure you want — like adding Engine
as a level or using 2 levels instead of 4.
Just make sure your product and vehicle CSV files are ready for import and match the structure defined in your MMY settings.
Changing the MMY setup after importing vehicles (which we’ll explain in the next article) will break the connection between vehicles and products. So choose your setup first before moving on.
How to setup MMY?
Go to Catalog › Vehicles & Fitments › Settings.
At the top of the page choose the number of fitment levels (2 to 4).
For each Level 1–4, click the Level Name to select it's type (e.g. Make, Year, Engine, Trim).
Click Submit to save your changes.
✅ Success! You’ve set up how vehicles are organized.
Now, when you import vehicles and products, the fitments will match correctly— making sure customers find parts that fit their vehicles. Keep reading to see your next step.
What's next
Once you've set up your MMY, import vehicles from a source that matches it to power the “Shop by Vehicle” filter.
If you're using an auto integration, most providers already follow the default format (Make / Model / Year / Submodel), so you're likely good to go without any extra setup.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!