view_item_list Event

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.

Shopify: Manual implementation required. Not automatically tracked.

JavaScript

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

view_category — For collection/category pages
view_content — When clicking through to a product
search — For search results specifically

view_category view_cart

⌘I

SDK

PIXEL EVENTS

IDENTITY

AUTOMATIC TRACKING

JavaScript

Properties

When to Fire

​JavaScript

​Properties

​When to Fire

​Related Events

JavaScript

Properties

When to Fire

Related Events