> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# view_item_list Event

> Track when a visitor views a list of products

Fires when a visitor views a list of products. This is similar to `view_category` but more general — use it for recommendation carousels, recently viewed sections, and other product lists.

<Note>
  **Shopify:** Manual implementation required. Not automatically tracked.
</Note>

## JavaScript

```javascript theme={null}
window._upstack('track', 'view_item_list', {
  items: [
    { id: 'SKU_001', name: 'Classic Cotton Tee', price: 34.99, index: 0 },
    { id: 'SKU_002', name: 'Vintage Logo Hoodie', price: 59.99, index: 1 }
  ],
  itemListId: 'recommended_products',
  itemListName: 'Recommended For You'
});
```

## Properties

| Property     | Type   | Required | Description                                                  |
| ------------ | ------ | -------- | ------------------------------------------------------------ |
| itemListId   | string | No       | List identifier                                              |
| itemListName | string | No       | List display name                                            |
| items        | array  | No       | Products in the list (include `index` for position tracking) |

## When to Fire

* Product recommendation carousel load
* "Related Products" section view
* "Recently Viewed" section view
* Search results page load

## Related Events

* [view\_category](/pixel/events/view-category) — For collection/category pages
* [view\_content](/pixel/events/view-content) — When clicking through to a product
* [search](/pixel/events/search) — For search results specifically