The view_item_list event
view_item_list is a GA4 recommended e-commerce event that fires when a visitor sees a list of products — a category page, search results, or a recommendation row. It carries an items array plus item_list_id and item_list_name so you can attribute impressions to a specific list. It measures product exposure: which lists put which items in front of people.
What this means
view_item_list fires when a collection of products is rendered together — a category grid, on-site search results, a 'related products' carousel. The event names the list with `item_list_id` and `item_list_name` and includes the `items` array of products shown. GA4 uses it to report item-list performance.
It is an impression-level signal: it says products were displayed, which is weaker than a view_item but essential for measuring exposure.
Pairing impressions with clicks
On its own, view_item_list tells you what was shown. Paired with select_item — fired when someone clicks an item in that list — it gives a click-through view of each merchandising surface. Use consistent list ids and names across pages so the same logical list aggregates correctly rather than fragmenting into near-duplicate labels.
- Fires when a list/grid/carousel of products renders
- Carries item_list_id, item_list_name, and an items array
- Pairs with select_item to measure list click-through
How it appears in analytics and logs
A view_item_list event means a set of products was shown together. Comparing it to select_item shows whether a list's items actually get clicked, not just displayed.
Diagnostic use case
Measure which product lists and merchandising surfaces expose which items, so you can compare list performance and reading impressions against clicks.
What WebmasterID can help detect
WebmasterID can record list-impression events first-party, so merchandising and category performance is measurable without third-party retail tags.
Common mistakes
- Using inconsistent list ids/names that fragment reporting.
- Firing it per item instead of once per list view.
- Confusing it with view_item (single product detail).
Privacy and accuracy notes
view_item_list describes which products were displayed, not who saw them. List names and item ids are catalogue metadata, not personal data.
Related pages
- The view_item e-commerce event
view_item is a GA4 recommended e-commerce event that fires when a visitor views a product's detail page. It carries an items array describing the product (id, name, price) plus currency and value. It sits early in the purchase funnel — between browsing a list and adding to cart — and is the foundation for product-level engagement and conversion analysis.
- The select_item event
select_item is a GA4 recommended e-commerce event that fires when a visitor clicks a product inside a list — selecting an item from a category grid, search results, or carousel. It carries the item plus the item_list_id and item_list_name it was chosen from. Paired with view_item_list, it turns impressions into click-through, showing which merchandising surfaces actually drive product views.
- E-commerce events: the funnel before purchase
E-commerce events are a recommended set that model the shopping funnel before and around purchase: view_item, add_to_cart, begin_checkout, add_payment_info, and purchase. Each shares a common items array, so the same product schema flows through the journey. Implemented consistently, they let you see where buyers drop off — and they carry product data, never buyer identity.
- Event Explorer
Drill into list-impression events.
Sources and verification notes
Last reviewed 2026-06-24. Facts are checked against primary/official sources where available; uncertain specifics are marked “Data not yet verified” rather than guessed.