Documentation | FitmentPro

Documentation

Learn how to set up and use FitmentPro for your auto parts store.

1. Getting Started

Welcome to FitmentPro! Follow these steps to set up vehicle compatibility filtering in your Shopify store.

Prerequisites

  • A Shopify store with Online Store 2.0 theme (Dawn, Craft, or similar)
  • Products that you want to add vehicle compatibility to
  • FitmentPro app installed from the Shopify App Store

Quick Setup (5 minutes)

  1. Install the app from the Shopify App Store
  2. Activate the theme widget in your theme customizer
  3. Add your first vehicle to any product
  4. Install Search & Discovery for collection filtering
  5. Configure filters for brands, models, and years

2. Theme Setup

FitmentPro provides several theme blocks that you can add to your store using the Shopify theme customizer.

Available Theme Blocks

  • Vehicle Selector: Main 6-stage filter for customers to find their vehicle
  • Vehicle Filter: Compact filter for collection pages
  • My Garage: Shows customer's saved vehicles
  • Compatibility Badge: Shows if product fits customer's vehicle
  • Compatibility Table: Full list of compatible vehicles
  • HSN/TSN Lookup: German registration code search
  • VIN Lookup: Vehicle Identification Number decoder for worldwide use
  • SEO Vehicle Data: Adds structured data for search engines

Adding a Block

  1. Go to Online Store → Themes → Customize
  2. Navigate to the page where you want the block
  3. Click Add section or Add block
  4. Look for FitmentPro in the app blocks
  5. Configure the block settings and save

3. Adding Vehicles to Products

There are multiple ways to add vehicle compatibility to your products.

Using the 6-Stage Selector

  1. Open a product in the FitmentPro app
  2. Select Brand (e.g., "BMW")
  3. Select Model (e.g., "3 Series")
  4. Select Platform (e.g., "F30")
  5. Select Variant (e.g., "320d")
  6. Select Year range (e.g., "2015-2019")
  7. Select Engine if needed
  8. Click Add Vehicle
  9. Save the product

Using HSN/TSN Lookup (Germany)

For German vehicles, you can use the registration document codes:

  1. Click HSN/TSN Lookup in the product editor
  2. Enter the 4-digit HSN (e.g., "0005")
  3. Enter the 3-character TSN (e.g., "CAU")
  4. The matching vehicle is automatically selected

Using Templates

Templates let you save common vehicle groups and apply them to multiple products:

  1. Go to Templates in the app
  2. Create a new template (e.g., "VAG MQB Platform")
  3. Add all relevant vehicles to the template
  4. Apply the template to products via bulk actions

4. VIN Lookup

The VIN (Vehicle Identification Number) decoder allows customers worldwide to identify their vehicle using the unique 17-character code found on the dashboard or door frame.

How It Works

  1. Customer enters their 17-character VIN
  2. FitmentPro decodes the VIN using the NHTSA database
  3. Make, model, year, and engine data are extracted automatically
  4. A multi-level scoring system ensures accurate vehicle matching
  5. The matched vehicle is applied to filter compatible products

Adding the VIN Block

  1. Go to Online Store → Themes → Customize
  2. Add the FitmentPro VIN Lookup block
  3. Configure display options (inline or modal)
  4. Save and publish your theme

5. Brand Whitelist

Control which vehicle brands are visible in your store to provide a focused browsing experience.

Setting Up Brand Filtering

  1. Go to Settings in the FitmentPro app
  2. Navigate to Brand Whitelist
  3. Enable or disable brands based on your product catalog
  4. Changes apply immediately to all storefront blocks

Only brands relevant to your inventory will appear in the vehicle selector, reducing clutter and helping customers find vehicles faster.

6. Bulk Import

For large catalogs, you can import vehicle-to-product mappings from Excel or CSV.

File Format

Your import file should contain these columns:

  • product_id or sku: Product identifier
  • brand: Vehicle brand (e.g., "Audi")
  • model: Vehicle model (e.g., "A3")
  • variant: Vehicle variant (optional)
  • platform: Platform/chassis code (optional)
  • year_from: Starting year
  • year_to: Ending year
  • k_type: TecDoc K-Type number (optional)

Import Process

  1. Go to Import/Export in the app
  2. Download the template file
  3. Fill in your data
  4. Upload the file
  5. Review the preview
  6. Confirm the import

7. Templates

Templates are reusable vehicle groups that speed up fitment assignment.

Creating a Template

  1. Go to Templates
  2. Click New Template
  3. Give it a descriptive name
  4. Add vehicles using the selector
  5. Optionally add tags and categories
  6. Save the template

Applying Templates

  • Single product: Open product, click "Apply Template"
  • Bulk: Select products, choose "Apply Template" action
  • Automation: Create a rule to auto-apply based on product attributes

8. Troubleshooting

Theme blocks not showing

  • Ensure your theme is Online Store 2.0 compatible
  • Check that the app embed is enabled in theme settings
  • Verify the block is added to the correct page template

Vehicles not appearing in filter

  • Make sure you saved the product after adding vehicles
  • Check that metafields are properly synced
  • Verify Search & Discovery filters are configured

Import errors

  • Ensure your file uses the correct column names
  • Check for invalid characters in vehicle names
  • Verify product IDs/SKUs exist in your store

Need More Help?

Check our FAQ for common questions, or contact support at support@fitmentpro.app.