Vehicle Filter Block

The Vehicle Filter block lets customers filter collection pages to show only products compatible with their vehicle.

How It Works

On a collection page, the filter appears alongside Shopify's native filters
Customer selects their vehicle using the cascade dropdown (Brand → Model → Platform → Year)
The collection page filters to show only products with matching fitment data
URL parameters are updated for bookmarking and sharing

Features

6-stage cascade — Full vehicle hierarchy filtering
Works with Shopify filters — Appears alongside native collection filters
URL persistence — Filter selections are saved in the URL
Mobile drawer — On mobile, opens as a slide-out drawer
Count indicators — Shows how many products match each filter option

Configuration

In the theme editor:

Position — Sidebar or above the product grid

Filter levels — Choose how many cascade levels (3–6)

Auto-apply — Apply filter immediately on selection or wait for a button click

Labels — Customize dropdown labels

Best Placement

Collection page sidebar — In the filter column, alongside other filters
Above product grid — As a horizontal filter bar

How Filtering Works

The filter uses Shopify's native collection filtering via the metafield-based filter metafields (vehicle_fitment.brand, vehicle_fitment.model, etc.). This means:

Filtering is fast and handled by Shopify's infrastructure

It works with Shopify's Search & Discovery app

No API calls or JavaScript are needed for the actual filtering