SKU Search Preflight — Help Center

Getting started

1. Open your storefront. Open your published Shopify store in a new browser tab.
2. Get your product CSV. Export your products from your Shopify Admin as a CSV file.
3. Import to the extension. Open the extension popup, click "Choose CSV", and select your exported CSV file.
4. Run your audit. Click "Run test". The extension scans your predictive search and search page endpoints directly from your browser context.
5. Review and share. Review the results on your screen, download the HTML report, or export a CSV to share with your developers.

Understanding Report Statuses

Exact Match

The storefront search returned the correct product as the top result. No action is required.

Improved by SKU Fields

The search did not find the product using default settings, but succeeded when forcing the variants.sku field.
Recommendation: Ask your developer to include SKU and Barcode fields in your theme's predictive search settings.

Wrong Match

The search returned results, but they pointed to a different product instead of the expected one.
Recommendation: Review if SKUs are unique or if your theme's search matches are too broad.

No Match

Storefront search returned no products.
Recommendation: Check if the SKU is published or if custom search apps are ignoring SKU fields.

Unclear

The storefront returned an invalid response, returned a 429 throttling error, or an external search app blocked same-origin parsing.

FAQ

Does the extension upload my CSV data?

No. SKU Search Preflight is built with privacy in mind. All CSV parsing, search fetches, and report generations happen entirely inside your local browser memory. No catalog data, SKUs, or storefront URLs are ever transmitted to our servers.

What are the CSV requirements?

The extension accepts standard Shopify product export CSV files. At a minimum, your file must contain the following headers (case-insensitive):

• Handle (used to verify if search points to the correct product page)
• Variant SKU (the search query we audit)

Including the Title column is highly recommended as it makes the generated reports much easier to read.

How do I activate my Pro license?

Paste the unique license key from your Gumroad receipt into the "License key" field in the extension popup and click "Activate license". Pro features are unlocked instantly.

Why does the scan return "Unclear" for some products?

This can happen due to Shopify rate limiting (429 throttling) if you run a large scan too quickly, or if your store uses an external search app that blocks/intercepts client-side request parsing. The extension flags these instead of failing the entire run.