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
  • 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. 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

5. 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

6. 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.