Product listing analytics
This guide explains Product listing analytics in the Admin panel: how shoppers use product grids (all products, categories, and search results), which filters appear in URLs, and how often they open a product detail page or add to cart from the listing grid.
Where to find it
Log in to Admin, open Settings, then Product listing analytics. The page path is /admin/settings/product-listing-analytics. Only staff who can access Settings will see this screen.
What this report is for
Use it to answer questions such as:
- Are shoppers mostly browsing all products, category pages, or search result grids?
- Which filter or sort parameters show up most often in the address bar (for example price range, sort order)?
- Which categories drive the most listing activity?
- Which products get the most detail opens or add-to-cart actions from the grid (not necessarily from the product detail page alone)?
This is listing behavior, not your full store revenue report. For orders, revenue, and funnel-style commerce metrics, use Admin → Analytics (see Analytics Dashboard).
How data is collected (plain language)
| Source | What is counted |
|---|---|
| Server | Each time the storefront renders a product listing page, a listing request can be recorded with the active query string (filters, sort, and similar parameters in the URL). |
| Browser | When a shopper clicks through to product detail from a card, or adds to cart from the grid, those actions are sent as lightweight events from the browser. |
Important limitations
- Ratios are approximate. They are not a strict step-by-step funnel per person. The same visitor can load the listing many times; they can add to cart without opening the detail page first; and timing or browser settings can affect browser-sent events.
- Listing requests count server renders with the current URL parameters, not “unique visitors.”
- Detail clicks and Add to cart (from grid) reflect interactions from the listing. They do not replace your full cart or order analytics on the main Analytics dashboard.
Data is used for your shop’s analytics features. It is designed to stay lightweight so normal browsing stays fast.
Reporting window
At the top of the page, choose how many days to include (Reporting window) and click Apply. If a period has no events yet, you will see a message that there is no data for that range.
Summary cards (metrics)
The labels match the Admin UI. Hover the ? icons on the live page for the same short definitions.
| Metric | Meaning |
|---|---|
| Listing requests | Each server render of a product listing (All products, Category, or Search) with the active query string. Includes filter and sort parameters. |
| Detail clicks | Clicks that go to the product detail page from a product card on a listing. |
| Add to cart (from grid) | Add-to-cart actions started from product cards while the shopper is viewing a listing. |
| Detail clicks / listing request | Detail clicks divided by listing requests in the period. Not a unique-user funnel. |
| Add to cart / detail click | Add-to-cart events divided by detail clicks. Shoppers can add to cart without opening detail first, so this ratio can exceed 100%. |
Tables on the page
- Requests by surface — All products (main catalog listing), Category (category pages), Search (search results listing). Helps you see where people spend time in the catalog.
- Top categories (by listing requests) — Category pages ranked by how many listing requests they received.
- Most common filter / query keys — Parameter names from stored URL snapshots (for example sort or price limits). Custom attribute filters appear under their field names.
- Most opened products (from listing) / Most add-to-cart (from listing) — Products that shoppers clicked or added from the grid most often in the selected period.
If everything is empty, either the period is too short or no listing activity has been recorded yet.
Related settings and reports
- Storefront search — How the search box, autocomplete, and search results page work for shoppers (URLs and behavior).
- Admin → Search settings — How search and autocomplete behave on the storefront (separate from this listing report).
- Admin → Settings → Search analytics — Aggregated search usage and conversions (different from Product listing analytics).
- Admin → Analytics — Revenue, orders, conversion funnel, and related commerce metrics.