FitmentKit

Support

Get help

Email [email protected]. Include your store's .myshopify.com address and, for an order question, the order number.

Getting started

The Overview screen in the app shows this checklist with a link to the right place for each step.

  1. Install FitmentKit Install it from the Shopify App Store and open it from Apps in your Shopify admin. Your products sync from Shopify straight away; a large catalog can take a few minutes.
  2. Add fitment Import a CSV of your own fitment (Import), or open a product and edit its fitment by hand. Either way the rules go live right away.
  3. Turn on the app embed Online Store → Themes → Customize → App embeds → switch on FitmentKit → Save. The other blocks need it.
  4. Add the vehicle bar Add the Vehicle bar block near the top of your home page, and on collection pages if you like. If your theme's header doesn't accept app blocks, add an "Apps" section to the header group and put it there.
  5. Add the fit badge and fits table On the product page template, add Fit badge and Fits table under the buy buttons.
  6. Add the cart check On the cart page template, add Cart check. It catches parts that don't fit before checkout.
  7. Add the "Fits vehicles" filter In Shopify's free Search & Discovery app, go to Filters, add the Fits vehicles filter and save. Without it, the vehicle bar's "Shop parts" button shows every product.

Save the theme after each change. Then visit your store, pick a car and open a product to see the badge.

Optional extras

Fit badges on product cards

Themes don't allow app blocks inside collection grid cards. To show badges there, add this line to your theme's product card snippet (card-product.liquid in Dawn), under the price:

<fk-fit-badge product-id="{{ card_product.id }}"></fk-fit-badge>

The car on the packing slip

Shopify admin → Settings → Shipping and delivery → Packing slips → Edit, then paste this snippet under the order details and save. It prints the vehicle, the VIN and the option answers (as short codes, like "brake package: steel").

{%- assign fk_vehicle = order.attributes['_fitmentkit_vehicle_name'] -%}
{%- assign fk_vin = order.attributes['_fitmentkit_vin'] -%}
{%- assign fk_answers = order.attributes['_fitmentkit_answers'] -%}
{%- if fk_vehicle != blank or fk_vin != blank -%}
  <div class="fitmentkit-vehicle" style="margin: 1em 0; padding: .5em; border: 1px solid #000;">
    {%- if fk_vehicle != blank -%}<p style="margin: 0;"><strong>Vehicle:</strong> {{ fk_vehicle }}</p>{%- endif -%}
    {%- if fk_vin != blank -%}<p style="margin: 0;"><strong>VIN:</strong> {{ fk_vin }}</p>{%- endif -%}
    {%- if fk_answers != blank and fk_answers != '{}' -%}
      <p style="margin: 0;"><strong>Options:</strong>
        {{ fk_answers | remove: '{' | remove: '}' | remove: '"' | replace: ':', ': ' | replace: ',', ', ' | replace: '_', ' ' }}
      </p>
    {%- endif -%}
  </div>
{%- endif -%}

Some packing-slip templates call the order's attributes attributes instead of order.attributes. If nothing prints on a test order, replace order.attributes with attributes.

Questions

Which vehicles does FitmentKit know?

US vehicles from 1981 on, by Year, Make and Model, built from NHTSA's public vehicle data, plus detailed Porsche and air-cooled Volkswagen data with generations, variants and options like brake package. You can add your own vehicles in the app, such as pre-1981 cars, race cars or models from other markets.

How does the VIN lookup work?

Shoppers can paste a 17-character VIN instead of using the dropdowns. It's decoded on our own servers, so there are no lookup credits. If a VIN could be more than one car, the shopper picks theirs. Cars built before 1981 don't have a 17-character VIN, so shoppers pick those by Year, Make and Model. You can hide the VIN link in the vehicle bar's settings.

What's a "question", like "Are your brake calipers yellow"?

Some parts depend on an option the Year / Make / Model doesn't tell you, like steel or ceramic brakes. When it matters, the vehicle bar asks one plain question with a button per answer. Shoppers can say "Not sure"; the badge then says "Depends on your brakes" instead of guessing. You can turn questions off in Settings.

How do I import fitment from a CSV?

Open Import in the app and upload or paste a CSV with one row per rule: the product's SKU or ID, then make, model, generation, variants, years and any options. Choose whether the file replaces a product's rules or adds to them. Imported rules are approved right away, because they're your own data. Valid rows import even when other rows have errors, and each problem row is listed so you can fix it and import it again.

What happens when an order's parts don't fit the car?

Within seconds of the order, FitmentKit tags it fitmentkit-hold, adds a note naming the line and the reason, and puts its fulfillment orders on hold. You'll find it under Order holds in the app, where you can see each line and release the order with a note. If you'd rather not hold orders, switch off "Hold orders that don't fit" in Settings and they'll only get a note.

What if a shopper keeps a part that doesn't fit?

The cart check lets shoppers choose "I know, keep it" (some know their car better than the data). They can then check out, and the order is flagged for your team so you can confirm before shipping.

Can every order be held?

Holds apply to fulfillment orders you manage in Shopify. Orders assigned to a third-party fulfillment app, or already fulfilled, can't be held; they still get the tag and the note. Holds are a safety net, not a guarantee, so keep your usual checks.

Will it slow down my store?

The storefront widget is about 17 KB gzipped, loads as a module so it doesn't block the page, and is served by Shopify from the theme app extension. Each page sends one request for all its fit badges.

Does it work with my theme?

FitmentKit uses Shopify theme app blocks, so it works with themes that support app blocks (Online Store 2.0 themes) and needs no theme code edits. The widget picks up its colors from settings, including a brand color you choose in the app.

How am I billed, and how do I cancel?

Every plan includes every feature; plans differ only by how many products have fitment. Paid plans start with a 14-day free trial, then are billed monthly through your Shopify bill, in US dollars. Change plans in the app. To cancel, switch to the Free plan or uninstall the app; Shopify ends the subscription when you uninstall. See pricing and the terms.

What happens to my data if I uninstall?

FitmentKit stops working in your store immediately. 48 hours later, Shopify asks us to delete your store's data, and we delete all of it: products, fitment, order checks and keys. If you reinstall before then, your data is still there. Details are in the privacy policy.

What customer data does FitmentKit keep?

No names, emails, phone numbers or addresses. For each order it keeps the car, the VIN if the shopper entered one, and their option answers, so your team can see why an order was held. See the privacy policy.

Is FitmentKit available outside the US or on other platforms?

Not yet. FitmentKit is for Shopify stores selling parts for US vehicles.

Didn't find your answer? Email [email protected].