Vehicle fitment

Fitment says which vehicles a part fits. Shoppers pick their year, make and model on your store and see only the parts that fit, and each product page answers "Does it fit my vehicle?". It's on every plan, and none of it shows on your store until you add vehicles.

There are two ways to say what a part fits, and you can use both:

• Vehicle categories. If you file parts under categories like Jeep Cherokee XJ 84-01, every product in the category fits that vehicle. A category whose name has a make and years links itself when you create or rename it, and its Vehicle box (on the category's edit page) shows and changes the link. Keep filing parts the way you do now: moving a product to another category changes what it fits.
• Fitment lines. For anything a category doesn't say, such as another vehicle, a submodel or engine, or only some of the years, add lines on the product's own Fitment page, or import them.

A part marked Universal fits every vehicle.

Vehicles

Catalog → Vehicles lists the vehicles you sell parts for. Each one has a make, a model, an optional submodel and engine, and its years. Leave the last year empty if the vehicle is still being made.

The category's Vehicle box

Open a category from Catalog → Categories. Under Vehicle, tick This category is a vehicle and fill in the make, model and years, or untick it if the category isn't one. When the name reads as a vehicle, Kaniva fills the box in for you. Click Update Category to save. Renaming a category it linked by itself moves the link to the new name; a link you set yourself stays as you set it.

Linking older categories

Categories made before fitment arrived, and ones Kaniva couldn't read (Toyota Tacoma 3rd Gen has no years), can be linked in one go:

1. Open Catalog → Vehicles. Under Create from your categories, Kaniva lists the categories whose names look like a vehicle (a make and years, like Ford Bronco 2021+), with the make, model and years read from the name.
2. Correct anything it read wrong, untick any that aren't vehicles, and click Link to vehicles.

To link a category later, or link one category to more than one vehicle, open the vehicle and pick its categories under Categories that stand for this vehicle, then click Save vehicle.

Add a vehicle by hand with Add a vehicle at the bottom of the page. Deleting a vehicle removes its category links and fitment lines; the categories and products stay.

A product's fitment

On the product's page, the Fitment card shows what the part fits. Click Edit fitment to open its Fitment page:

• From its categories lists what its vehicle categories already say. Change those on Catalog → Vehicles.
• Tick Universal for a part that fits anything, like a sticker or a recovery strap.
• Under Fitment lines, pick a vehicle and, if needed, narrow the years (leave them empty to use the vehicle's own), and add a position (Front), a note (Needs a 2" lift) or a quantity. Click Save fitment. To remove a line, set its vehicle to Remove this line and save.

A vehicle with a submodel or engine only matches shoppers who pick that one, or who don't choose a submodel. A line for a vehicle with no submodel fits all its submodels.

Importing fitment

From a spreadsheet. Under Import fitment on Catalog → Vehicles, upload a CSV with one line per part per vehicle. Click Download a template for the columns: sku (the product's part number), make, model, year_from, year_to, and optionally submodel, engine, position, note and qty. Kaniva finds the vehicle by make, model, submodel and engine, or adds it. A line that's already there is updated, not added again. A line with make Universal and no model marks the part Universal. Lines Kaniva can't place (no product with that part number, years that don't make sense) are listed after the import.

From an ACES file. ACES is the auto parts industry's fitment format, and many suppliers send their catalogue in it. ACES names each vehicle by its number in the Auto Care Association's vehicle database (the VCdb), which is a paid subscription. Once a VCdb subscription is connected to your store, upload the XML file under ACES file. Kaniva matches each line to a product by part number, joins consecutive years into one line, and replaces the earlier ACES lines of the parts the file lists. Lines you typed or imported from a CSV stay. Until a VCdb is connected, Kaniva reads the file, tells you how many lines it has, and changes nothing. Contact us to connect yours.

With a VCdb connected you can also click Export ACES to download your fitment as an ACES file, for marketplaces and partners that take one.

On your storefront

Once a vehicle with a first year is linked to a category with products on sale, or used on a product's fitment lines, your store shows the vehicle picker. It works the same on every theme.

• The shop has a Shop by vehicle picker above the products. It only offers the years, makes and models you have parts for. Once a shopper picks a vehicle, the shop leaves out the parts made for other vehicles. It still shows the parts that fit, Universal parts, and parts that aren't for a vehicle at all. The bar above the list offers Show all parts, Change vehicle and Clear vehicle.
• Product pages say Fits your 2015 Jeep Wrangler JK (with any position or note), or Doesn't fit your …, and list every vehicle the part fits. A shopper who hasn't picked a vehicle can check from there.
• My Garage. The vehicle a shopper picks is remembered on that device. A signed-in customer also has it saved to My Garage (in their account menu), where they can keep several vehicles and switch between them.

A product that's in no vehicle category, has no fitment lines and isn't ticked Universal isn't a vehicle part (a tool holder, a T-shirt). Its page shows nothing about vehicles, and it stays in the shop whatever vehicle a shopper picks.