Vehicle Fitment & YMM Search for WooCommerce

Overview

Year / make / model parts search for WooCommerce. Shoppers pick their vehicle and see only the parts that fit; every product page says whether the part fits the vehicle in their garage.

Requirements: WordPress 6.7+, WooCommerce 10.1+ (tested with 11.2), PHP 7.4-8.3. Works with block themes (Twenty Twenty-Five) and classic themes (Storefront), High-Performance Order Storage (HPOS) and the Cart and Checkout blocks.

Installation

1. Download the plugin zip from your account (kaviolabs.com), your CodeCanyon downloads or WooCommerce.com.
2. In WordPress go to Plugins > Add New > Upload Plugin, choose the zip, click Install Now, then Activate. WooCommerce must be installed and active.
3. On activation the plugin creates two database tables ({prefix}kv_vf_fitment, {prefix}kv_vf_vehicle).
4. Add vehicles to your products (Adding fitment data).
5. Place the vehicle search on your home page or in a sidebar (Storefront).
6. Own-site and CodeCanyon editions: enter your licence key or purchase code in WooCommerce > Settings > Vehicle fitment (Settings and licence).

Updating

Upload the new zip the same way and confirm Replace current with uploaded. Fitment data and settings stay.

Removing

Deactivating keeps everything. Deleting the plugin keeps the fitment data unless Remove data on uninstall is on.

Settings and licence

WooCommerce > Settings > Vehicle fitment

Licence

• Own-site edition (kaviolabs.com): enter your licence key (KAVIO-XXXX-...). New installs have a 14-day start period. Without a valid licence the storefront features switch off; your data and the admin screens stay. The check runs once a day from the admin area only and sends the site address and the key, nothing else.
• CodeCanyon edition: enter your purchase code for updates and support. All features work without it.
• WooCommerce.com edition: no licence field; WooCommerce.com handles your subscription.

Development sites (localhost, .test, .local, private IP addresses) always work.

Storefront

Vehicle search

Three ways to place it:

• Block "Vehicle search" (category WooCommerce): title, button text, horizontal or vertical layout, My Garage on/off.
• Shortcode [kv_vehicle_search title="Find parts for your vehicle" layout="horizontal|vertical" garage="yes|no" button="Find parts" target=""]. target is a results URL; empty = the shop page; current = the current product category.
• Widget "Vehicle search (YMM)" for classic theme sidebars.

Years are listed newest first. Make and model load as the shopper chooses (a small, cacheable REST call). Submodel and engine appear only when your data has values for the chosen vehicle; both are optional.

Find parts opens the shop page (or, with "Search in category" on, the current category) filtered by the vehicle.

Filtered catalogue

With a vehicle in the URL (?kvf_y=2018&kvf_mk=Ford&kvf_md=F-150, plus kvf_s / kvf_e), the shop page, product categories, tags, attributes and the product search show only:

• products with a row for that year, make and model (rows for another submodel or engine are left out once the shopper chose one), and
• universal products (setting "Universal parts").

A banner names the vehicle with a Show all products link. Sorting, pagination and other filters keep working.

Fit badge

Above the add to cart button of products with fitment data:

• Fits your 2018 Ford F-150 (green), with the notes of the matching row
• Does not fit your 2018 Ford F-150 (red)
• May fit your 2018 Ford F-150: choose the submodel and engine to confirm (amber)
• Universal fit (blue)
• Check if this part fits your vehicle when no vehicle is chosen yet

Select vehicle / Change vehicle opens a compact selector in the badge; the answer updates without reloading. Shortcode for custom templates: [kv_vehicle_fit product="123"].

Fitment tab

A Vehicle fitment (N) tab lists every vehicle (years, make, model, submodel, engine, notes). Lists with more than 10 vehicles get a filter box. Shortcode: [kv_vehicle_fitment_table product="123"].

My Garage

The last vehicles a shopper searched (default 5, up to 10) appear as chips under the search; one click searches again, the x removes one. The garage is stored in the shopper's browser (localStorage): no account, no cookie, nothing on your server, and pages stay cacheable by full-page caches and CDNs.

Adding fitment data

A fitment row links one product to one vehicle line: a year or a year range, make, model and, when it matters, submodel and engine. An empty submodel or engine means "all submodels / engines". Notes (for example "Front axle") appear in the fit badge and the fitment table. A universal product fits every vehicle.

Fitment is stored on the parent product; variations share the fitment of their product.

In the product editor

Open a product, tab Vehicle fitment:

• Universal fit: tick it for parts that fit every vehicle.
• One row per vehicle line: Year from, Year to, Make, Model, Submodel, Engine, Notes. Add vehicle copies the year, make and model of the row above, so families of trims are quick to enter. Rows without a valid year, make or model are ignored when you save.
• Products with more than 300 rows are edited through CSV export and import.

CSV import

Products > Vehicle fitment > Import.

Header names are case-insensitive and common aliases work (trim, part_number, start_year ...). Comma, semicolon, tab and pipe delimiters are detected. Example:

sku,year,make,model,submodel,engine,notes,universal
KVF-BRAKE-01,2015-2020,Ford,F-150,,,Front axle,
KVF-BRAKE-01,2021-2023,Ford,F-150,XLT,3.5L V6,Front axle,
KVF-MOUNT-01,,,,,,,yes

1. Choose the file and click Upload and preview. Nothing is saved yet.
2. The preview shows the number of rows, the columns found, a sample of the rows with the matched products, and the rows that will be skipped with the reason (unknown SKU, invalid year ...).
3. Choose the mode and click Import:
   • Merge adds the rows and updates the notes of rows that already exist. Other rows stay.
   • Replace makes every product in the file keep only the rows of the file. Products not in the file are not touched.
4. The import runs in the background in chunks of 1,000 rows (Action Scheduler, group kv-vehicle-fitment). You can leave the page; the progress bar updates while it is open. The report lists up to 200 skipped rows with line numbers.

Files up to 50 MB are accepted. Duplicate rows of a product are stored once.

CSV export

Products > Vehicle fitment > Export > Download CSV writes every row with product_id, sku, product_slug, years, vehicle, notes and universal. The file imports back unchanged: edit it in a spreadsheet and import it with Replace. Cells that start with =, +, - or @ are prefixed with an apostrophe (spreadsheet formula guard).

Tools

• Rebuild vehicle list: recreates the year / make / model lists of the search from the fitment rows (only needed after restoring a database backup).
• Delete all fitment data: removes every row (type DELETE to confirm).

FAQ

Do you include a vehicle database (ACES / VCdb)?

No. You import the vehicles your parts fit, so the lists only contain vehicles you sell parts for.

How many rows can it handle?

Rows live in indexed database tables. Imports run in the background in chunks, so files with hundreds of thousands of rows work; the shop filter adds one indexed sub-query to the product query (no post meta queries).

Does it work with my theme?

Block themes (the Product Collection block that inherits the query from the template) and classic themes (the main product query and woocommerce_before_shop_loop). Tested with Twenty Twenty-Five and Storefront.

Does it work with page caching?

Yes. The page HTML never depends on cookies; the garage and the fit badge run in the browser, and the selector lists come from a cacheable REST endpoint (/wp-json/kv-vehicle-fitment/v1/options).

Can I filter only one category by vehicle?

Yes: place the search on the category page (with "Search in category" on) or use the shortcode with target="current".

Variable products?

Fitment belongs to the product; all its variations share it. A variation SKU in the CSV maps to its product.

What happens on uninstall?

Settings and data stay unless "Remove data on uninstall" is on. Orders are never touched.