Quickstart: first vehicle search

This gets a shopper from "I drive a 2019 F-150" to a grid of parts that actually fit. It assumes the app is installed and the first index has finished.

1. Confirm the index is healthy#

Open Indexing. You want a completed job with a product count close to what Shopify reports. If products failed, each failure lists a reason — most commonly a malformed spec metafield.

2. Connect one fitment source#

Start with whatever you already have. In order of least effort:

Already tagging products?

Go to Fitment data → Sources and enable tag parsing. If your tags match the fits_… grammar, you're done in one click.

Have a supplier CSV?

Upload it. Columns are SKU, Years, Make, Model, Submodel, Note.

Keep a sheet?

Paste the Google Sheets URL and the app re-reads it on a schedule.

Have none of the above?

Ask your suppliers for a fitment export — most have one. If you sell wheels or tires, the Fitment Data add-on can judge their specs with no mappings at all.

Save, then run Reindex so the mappings are resolved into the index. Fitment coverage on the Dashboard should climb.

3. Map your collections#

Under Storefront → Collections, add the collections a shopper should see after they pick a vehicle — your top-level categories, whatever they are: Suspension, Brakes, Lighting, Wheels, Exhaust, Interior, Towing. Order them, give them images if you don't like Shopify's, and toggle off anything seasonal.

4. Place three widgets#

You do not need all nine on day one. This trio is the shortest path to a working funnel:

1. App embed: WySync bootstrap Theme editor → App embeds → enable. This is the shared vehicle state.
2. YMMS hero Add it to your homepage, above the fold. Leave the redirect blank to send shoppers to /collections.
3. Collection page On your main collection template, remove (or hide) the native product grid and add the WySync collection block in its place.

5. Test it like a customer#

Open your storefront in a private window and:

1. Pick a vehicle you know you carry parts for.
2. Confirm the collection list shows your mapped collections.
3. Open a collection — the grid should be filtered, and the count should be lower than the unfiltered total.
4. Open a product that fits, then one that doesn't. The verdicts should differ.
5. Add the fitting one to the cart and check the line item carries the vehicle.

6. Then add the rest#

Once the core funnel works, layer on the persistent bar, garage, search takeover, fitment table and cart re-verification. Each one is independent — adding one never breaks another.