Search & filters
Filters
Built-in filters plus your own metafield facets.
Filters come in two kinds: the built-ins you always have, and the ones you define from your own metafields.
Built-in#
- Price
- a range slider bounded by the actual min and max of the current result set.
- Stock
- in stock, low stock, out of stock. The low-stock threshold is yours to set. Which options are preselected is configurable, and defaulting to "in stock" is usually right.
- Vendor
- dropdown or checkboxes depending on how many brands you carry.
- Fitment
- the "fits my vehicle" toggle, present whenever a vehicle is active.
Merchant-defined#
Every mapped metafield can become a filter — lift height, rotor diameter, pad compound, beam pattern, hitch class, blade length, finish, whatever your catalog carries. For each one you set:
- Display name — what the shopper reads, not what the metafield is called
- Control type — checkbox, range, radio or dropdown
- Display order — drag to reorder
Type drives what is possible: a decimal field can be a range, a multi-value text field wants checkboxes.
Smart show and hide#
If no product in the current result set has a value for a field, that filter is not rendered. Browsing lighting does not show a Rotor Diameter filter with zero options, and a collection of universal accessories shows almost no filters at all.
This is automatic and cannot be turned off, because a filter with no options is a dead end that makes a store look broken.
Ordering that works#
The rule is the same in every category: fitment first, then the attribute people actually shop by, then price and brand. Fitment is the strongest cut; price belongs low, because a shopper who has narrowed to five fitting options is choosing, not sorting.
| Category | Order that tests best |
|---|---|
| Wheels | Fits my vehicle → diameter → width → bolt pattern → finish → price → brand → stock |
| Suspension | Fits my vehicle → lift height → kit type → brand → price → stock |
| Brakes | Fits my vehicle → axle position → compound → rotor style → brand → price |
| Lighting | Fits my vehicle → size → beam pattern → colour temp → brand → price |
| Service parts | Fits my vehicle → brand → price → stock |
Mobile#
Filters become a bottom sheet with a live "Show N results" button. The count updates as options are toggled, so a shopper knows before they commit whether they have filtered themselves down to nothing.
Twelve facets look thorough and convert worse than five. Map every metafield you like — but only promote the ones a customer actually shops by.
Support is answered by the people who wrote this code — not a ticket queue.