Product

One vehicle. Nine surfaces.
The same answer everywhere.

WySync Fitment is a Shopify app and a theme extension. The app indexes your catalog and resolves fitment; the extension puts nine widgets on your storefront. They share one piece of state — the shopper's vehicle — so nothing ever contradicts anything else. It does not care what you sell, only that it fits some vehicles and not others.

01ArchitectureHow a fitment answer is produced

Ingest

Your products come out of Shopify through a GraphQL bulk operation — titles, variants, prices, inventory, collections and metafields. Nothing is copied into a WySync product table; Shopify stays the source of truth.

Resolve

Every fitment source you've connected is merged into one set of vehicle IDs per SKU. Tags are parsed, CSV and Sheets rows are expanded across year ranges, metafield specs are canonicalised, editor overlays are applied last.

Serve

The resolved documents land in a per-shop Typesense index with Redis in front. Storefront widgets query that index through a signed app proxy — never Shopify, never our database.

Why it matters: the shopper's page never waits on Shopify's Admin API for a fitment decision, so fitment filtering costs about the same as a normal collection page — and stays fast on a 300,000-SKU catalog.

Typed spec fields, not a wheels schema

The index carries whatever attributes your products have, in five typed families — spec_num_*, spec_int_*, spec_str_*, spec_strs_*, spec_bool_*. Blade length, pad compound, rotor thickness, hitch class, bed length and attachment type behave exactly like diameter, offset and bolt pattern do. Nothing about the engine is wheel-shaped.

Wheels & tires

Bolt pattern, offset, hub bore, diameter and load rating — the hardest fitment in the aftermarket, and the one we started with.

Suspension & lift

Lift and lowering kits, coilovers, control arms, leaf packs. Fitment by platform, often by trim and drivetrain.

Brakes & drivetrain

Rotors, pads, big brake kits, axles, differentials. Front/rear position matters as much as the vehicle does.

Lighting & electrical

Bars, pods, fog kits, harnesses, tail lights. Direct-fit SKUs that live or die on the year range.

Engine & exhaust

Intakes, cat-backs, headers, tuners. Fitment is often engine-specific inside one model.

Exterior & protection

Tonneau covers, bull bars, fender flares, floor liners, roof racks, mud flaps.

Towing & utility

Hitches, wiring harnesses, brake controllers, ball mounts.

Service & consumables

Wipers, filters, belts, bulbs — high-volume parts nobody wants to return.

02The widgetsAll nine, every plan
Find parts for your vehicle
2024Ford
F-150LariatGo

Homepage

YMMS hero

Year / Make / Model / Submodel above the fold. Submitting routes the shopper into a catalog already filtered to their vehicle — whatever you sell for it.

How to set it up
2024 Ford F-150 Lariat ChangeClear
Fits
Fits
Fits

Every page

Persistent vehicle bar

The selected vehicle follows the shopper across the store, collapsing to a compact pill on mobile. Change or clear in one tap.

How to set it up
Your garage3 saved
2024 Ford F-150
Lariat · active
Active
2021 Honda Civic
Si
Use

Header or sticky

Garage

Multiple vehicles per shopper — the daily driver, the work truck, the project car. Syncs to the customer account when they're logged in.

How to set it up
FILTERSFits my vehicle
SuspensionIn stock

Collections

Collection page

Replaces the native product grid with a Typesense-backed one: fitment filtering, your own metafield facets, price and stock filters, four sorts.

How to set it up
Shop for your 2024 F-150
Wheels
Lift
Brakes
Lighting

Post-search

Collection list

The landing surface after a vehicle is picked. Shows only the collections you mapped, with your imagery and order.

How to set it up
Fits your 2024 Ford F-150 Lariat
6" lift · bolt-on · no cutting required
Confirmed by: supplier feed, fitment editor
Add to cart

Product page

Product fits check

A plain-language verdict for the shopper's vehicle — fits, does not fit, or unconfirmed — with your copy and your escape hatch.

How to set it up
This part fits 412 vehicles
YearsMakeModel
2015–2026FordF-150
2019–2026FordRanger
2018–2026FordExpedition
2007–2021LincolnNavigator

Product page

Fitment table

The full compatibility list for a SKU — every vehicle it fits, year-ranged and grouped, from your mappings and spec matching combined.

How to set it up
6" Lift Kit
2024 Ford F-150
Fits
MR305 17×8.5
2024 Ford F-150
No fit
1 item doesn't fit — review before checkout

Cart & checkout

Cart re-verification

Re-checks every line against the active vehicle before checkout, and can hard-gate the checkout button when something no longer fits.

How to set it up
apexparts.com/pages/2019-ford-f-150-parts
2019 Ford F-150 Parts & Accessories

SEO

Vehicle landing pages

Indexable pages for every vehicle you carry — "2019 Ford F-150 parts" — generated on a schedule from real published collections.

How to set it up
03Fitment dataSix ways in

Fitment comes from wherever you already keep it.

Sources merge as a union. If any connected source confirms a SKU fits a vehicle, it fits — so you can start with the tags already on your products and add a supplier feed later without re-doing anything.

Free

Product tags

fits_2018_2024-ford-f-150

Free

CSV upload

SKU, years, make, model, submodel, note

Free

Google Sheets

Polled on a schedule, no re-upload

Free

Metafields

Per-product specs already in your catalog

Plan

Vendor feeds

16 supplier adapters in the registry

+$150

WySync Fitment Data

Spec matching · wheels & tires only

The editor is the escape hatch

Supplier data is never perfect. The fitment editor sits on top of your sources as an overlay: add a vehicle a feed missed, exclude one it wrongly claims, flag a SKU universal, or attach a note that shows on the product page ("requires trimming", "not with factory tow package"). Your edits survive every reindex — they are applied after the sources merge, not baked into them.

Normalization you can see

"Chevy" and "Chevrolet" are the same make; "F150" and "F-150" are the same model; "5x114.3" and "5x4.5″" are the same bolt pattern. Physics ships in code, vocabulary is a per-shop synonym list you can read and edit — no black box deciding your catalog is wrong.

04WySync Fitment Data+$150/mo

For wheels and tires,
you can skip the mapping entirely.

This add-on is category-specific and we'd rather be blunt about it: it covers wheels and tires. For those, the engine switches from "look up a mapping" to "judge the specs" — canonicalised bolt pattern, diameter and width envelope, offset range, hub bore, and exact tire sizes against factory, guaranteed and aggressive tiers. Every other category keeps using the sources you connect, which is what most of this app is.

  • Tiered verdicts — stock, aftermarket and aggressive are different answers, not one "compatible" flag.
  • Honest negatives — when the specs rule a fit out, the engine says does not fit rather than shrugging.
  • Everywhere at once — search, collections, the product page verdict and the fitment table all read the same judgement.
  • Nothing to maintain — no credentials, no sync, no file. It is an entitlement on your shop, not an integration.
Not selling wheels or tires? Skip it — the app works fully without it. And note it's a different product from the WySync data subscriptions, which sell a wheel and tire product catalog rather than fitment intelligence.
05Merchant adminSeven sections

The admin is built for people who run a parts store.

Everything is inside Shopify admin, in Polaris, with no separate login. Seven sections, each doing one job.

Dashboard

Searches, vehicles, zero-result queries, fitment coverage and index health.

Fitment data

Sources and the editor — connect, upload, poll, override.

Storefront

Widget install status with deep links into the theme editor, mapped collections, vehicle pages.

Search & filters

Facets, ranking weights, normalization rules and synonyms.

Indexing

Job history, manual reindex, per-product failures with reasons.

Settings

Copy templates, no-data behaviour, billing and plan.

Support

Direct line to the people who wrote the engine.

Docs

This site, linked from every page of the admin.

Next

Read the docs, or just install it.

Thirty-day trial on every plan. Setup and the theme install are included — we do them with you on a call.