Skip to main content
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

PropertyTypeRequiredDescription
itemListIdstringNoList identifier
itemListNamestringNoList display name
itemsarrayNoProducts 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