Running Scans

The Scans tab is where every scan starts and where its findings show up. A scan is always read-only - SQA reads your storefront, catalog, and theme, but never writes to any of them.

Starting a Scan

Click Run Tier 1 scan to start. Tier 1 crawls your live storefront (or your configured preview URL), seeds every product, collection, and page from the Admin API so nothing un-linked gets missed, then runs every enabled check against the result - plus your catalog and theme source, if the app has a valid admin session.

Watching a Scan Run

The page polls automatically every couple of seconds while a scan is in progress, showing:

Crawling - SQA is following links and building the list of pages to check. This stage has no fixed length, so the progress bar is indeterminate.
Checking - each check runs in turn against the crawled pages; the bar fills in as checks complete, and the current check’s name and the number of pages found are both shown.

Auditing a Theme File

Drag and drop a theme .zip onto the drop zone, or click it to choose a file, before starting a scan. This is optional and useful for auditing a theme before it’s ever pushed to your store.

Run Tier 1 scan with a theme attached checks the uploaded zip in addition to your live theme and storefront
Scan theme file only appears once a file is attached - it skips the live crawl and every storefront/catalog check entirely, and only audits the uploaded theme

100 MB limit, 25 MB for full asset checking

A theme file must be a .zip under 100 MB. Above 25 MB, binary assets (images, fonts, video) in assets/ are stripped out before scanning - the code and content are still fully checked, and a finding in your report calls out exactly how many files were excluded and why.

Choosing Checks for This Scan

Click Choose checks to see every available check, seeded from your saved Settings defaults. Untick anything you don’t want to run - this only applies to the scan you’re about to start. To change what’s on by default for every future scan, use the Checks to run section in Settings instead.

Reading a Completed Scan

Once a scan finishes, you’ll see:

How many pages the scan was checked against
A badge for every check that ran, showing its name and finding count - green means it found nothing
A warning banner listing any check that couldn’t complete (it panicked or errored) - the rest of the scan still finishes normally
A success banner if the whole scan came back with no issues found

Findings

Each finding is shown as a card with:

The check type and a severity badge (see severity levels)
A status badge - new, recurring, resolved, or dismissed (see Reviewing Results)
The exact location of the issue, plus any extra detail a check attaches - for example, a broken link’s destination and HTTP status code
A plain-language fix instruction
An Open in admin link when SQA knows the exact Shopify resource, or an Open page link to the storefront URL otherwise
A Dismiss button, unless the finding is already resolved or dismissed

Exporting Findings

Once a scan completes with at least one finding, click Export CSV to download every finding - check, severity, location, detail, fix instruction, and status - as a spreadsheet you can share or track outside the app.

Viewing a Past Scan

Clicking View on any scan in Scan History brings you back to this page with that scan’s findings loaded, so you can revisit an older scan’s results at any time.