Reports
Reports turn your search-queries data into downloadable CSVs you can open in a spreadsheet, share with a buyer or merchandiser, or feed into another tool. Pick a report type, pick a time window, click Generate. The file is ready within seconds for small windows; longer windows may take a minute or two.
What's on the page
The Reports page in your dashboard has two sections.
- Generate a report
- Four cards, one per report type. Each has a time-window dropdown and a Generate button.
- History
- Every report you've generated in the last 7 days, with status (Generating, Download, Failed, Expired), the row count, and the file size.
The four report types
Top Search Queries
One row per distinct query in the window. Counts how many times each query ran, when it last appeared, the average number of results returned, and the rate at which shoppers got no matches. Sorted by frequency, so the most-searched queries are at the top.
Use this for prioritizing merchandising attention, spotting popular queries that aren't converting (high no-match rate), and writing copy that mirrors what your shoppers actually call things.
Trending Queries
Movement comparison. For each query, compares the current window's frequency to the prior window of the same length. Surfaces newly trending searches, queries that are accelerating, and ones that have dropped off. Sorted by absolute change so the biggest movers are at the top.
Use this for spotting seasonal demand swings, identifying queries that need new landing pages, and noticing when interest in a category has gone quiet (often a signal to refresh creative or merchandising).
Demand Gaps
Live shopper searches that returned no matches, aggregated by query text with counts and last-seen. Each row is a question your catalog isn't answering yet.
Use this for sourcing decisions (what should you stock that you don't), product description fixes (sometimes you carry the thing but your titles don't say it the way shoppers do), and variant gap-spotting (the right item, the wrong color or size).
Search Queries Log
Raw event log. One row per query event. Timestamp, the query text, result count, status, and source (Shopify storefront capture, public API call, imported, etc.).
Use this for full-fidelity exports when you need every event (e.g. for a downstream warehouse), or when you want to see the chronological sequence of a session's searches rather than the aggregate.
Time windows
Each report supports four window lengths: 7 days, 30 days, 90 days, or 365 days. All windows look backward from the moment you click Generate.
For Trending Queries specifically, the "prior window" used for comparison is the immediately preceding window of the same length. So a 30-day Trending report compares "the last 30 days" against "30 days before that."
How generation works
Reports run in the background on our side. After clicking Generate, the card switches to a Generating status; you can leave the page. Open the Reports page later and the History table will show the file as ready.
If you click Generate again with the same report type and window while a recent one is still fresh, you'll get a link to the existing file rather than generating a duplicate. (Identical requests within a short window hit a dedupe.)
History and retention
Generated files are kept for 7 days, then deleted automatically. The history row stays visible until the file expires, then drops off. Re-generate at any time to get a fresh file.
The download links themselves are short-lived signed URLs. If a download link stops working, just refresh the Reports page; the dashboard re-issues a current link.
Plan availability
Reports are included on higher plan tiers. On lower tiers, the Reports page shows the report types so you can see what's available, but Generate is disabled. Move up a tier in your plan to unlock them.
Limits
There's a soft cap on concurrent generations per property (usually only one at a time) to keep one heavy export from delaying another. If you hit it, you'll see "another report is currently being generated"; wait a moment and try again.
What we don't include
Reports cover search queries, not orders or shopper identities. We don't ship cart-add or order detail in these CSVs even though we capture those events for ranking; that data belongs to your Shopify Admin and your warehouse, not a downloadable CSV from us.