WySync Fitment Documentation

Everything you need to get started and get the most out of WySync Fitment.

Getting Started

WySync Fitment turns any Shopify wheel & tire store into a vehicle-first shopping experience. Shoppers pick their year, make, model, and submodel once; the app then filters collections to what fits, verifies fitment on product and cart pages, and stamps the vehicle onto the order. It's built for wheel & tire retailers, but works for any store that sells vehicle-specific parts.

Installation

1. Request early access (the app is finishing Shopify App Store review) — we'll send an install link; then click Install
2. Approve the requested permissions
3. The app opens inside your Shopify admin and runs the first full catalog index
4. Add the storefront widgets from your Shopify theme editor (the app's Widgets page shows live install status and deep links to the right spot in the editor)

Storefront Widgets

Eight storefront surfaces ship with the app. All of them are theme app extension blocks — you add them in the Shopify theme editor and customize colors, labels, and layout there. No code edits, no theme surgery.

• Vehicle Hero — a homepage year/make/model/submodel selector that routes shoppers to vehicle-filtered browsing
• Persistent Vehicle Bar — keeps the active vehicle visible (and changeable) on every page
• Garage — shoppers save multiple vehicles and switch between them
• Collection List — a curated, vehicle-aware list of your collections
• Collection Grid — replaces native collection pages with fast, fitment-filtered product grids, spec filters, and fitment badges (works on every collection, including /collections/all)
• Product Page Fitment — a "Fits your 2021 Ford F-150" / "Does not fit" panel on every product page
• Cart Fitment — re-verifies every cart line against the active vehicle before checkout
• Vehicle Selector Modal — the shared picker that opens from the bar, garage, product, and cart widgets

The vehicle and fitment status are written to cart lines as line item properties, so they carry through to the Shopify order — your team sees exactly which vehicle each item was bought for.

Fitment Data Sources

A product fits a vehicle if any connected source confirms it — sources merge, with no precedence rules to manage.

• CSV upload — lowercase columns sku, year, make, model, submodel, note, universal (submodel, note, and universal optional; any other column name is rejected). The year column accepts a single year (2024), a range (2020-2024), a comma list (2024,2026), or a combination (2020-2024,2026). A blank sku inherits the SKU from the row above, and a blank submodel matches every submodel. Grab the ready-made template on the app's Fitment Data page.
• Google Sheets link — same columns as the CSV; the app re-syncs it on a schedule
• Product tags — fits_<year>-<make>-<model>[-<submodel>]. Single year fits_2024-honda-civic, dash range fits_2018-2022-ford-mustang, pipe-separated list fits_2010|2012-toyota-camry, or with a submodel fits_2018-honda-civic-si.
• Metafields — per-product specs (diameter, width, bolt pattern, offset, and any others you map) power the collection filters
• Vendor integrations — connect a supplier fitment feed; contact us to set one up

Indexing

Your product catalog is indexed from Shopify into a dedicated, isolated search index for your store — that's what makes collection pages and filters fast. Your product data is never stored in the WySync database; Shopify remains the source of truth.

• Starter: full reindex automatically every 6 hours, plus a manual reindex button in the app admin
• Growth: real-time updates via Shopify product and inventory webhooks, with a daily full reindex as a safety net

The Indexing page in the app admin shows job history, product counts, and per-product diagnostics for anything that couldn't be indexed.

Billing

• Starter: $49/month — all 8 widgets, 6-hour indexing cycle, 1 CSV upload + 1 vendor integration
• Growth: $99/month — everything in Starter, plus real-time webhook sync, daily safety-net reindex, and unlimited fitment data sources
• Free trial: 14 days on both plans
• Cancel: Anytime via Shopify admin → Settings → Apps

Pricing subject to change at launch. Billed through Shopify.

FAQ

Does it work with my theme?

Yes — the widgets are Shopify theme app extension blocks, so they work with any Online Store 2.0 theme and inherit your theme's look. You place and customize them in the theme editor.

Where does my product data live?

In your Shopify store. WySync Fitment indexes it into an isolated per-store search index to power the storefront widgets, and never stores your catalog in its own database. Uninstalling deletes the index.

What happens to products without fitment data?

You choose: show them as "universal fit", show a "no fitment data" notice, or hide them from vehicle-filtered results entirely. You can also restrict the index to products that have fitment data.

Can shoppers save more than one vehicle?

Yes — the Garage widget stores multiple vehicles in the shopper's browser, and they can switch the active vehicle from the garage or the persistent bar at any time.

Do I have to build my fitment data from scratch?

No. Start with product tags or a single CSV, connect a vendor feed, or use the optional WySync data subscription for curated wheel & tire fitment data.

Support

Need help? Reach us at [email protected]. We typically respond within 24 hours.