Event Reference

Every event Ceres can track, and exactly how each one fires.

Storefront events

Toggle these on individually from the Events page. Each one runs automatically once enabled — no theme changes needed, except where noted below.

view_item

Fires when a shopper views a product page.

How it fires: Reads Shopify's own product data as soon as the page loads, retrying briefly if it isn't ready yet, with a fallback to the page's structured product data. Fires once per product per page view.

view_item_list

Fires when a shopper views a collection or search results page.

How it fires: Reads the list of products Shopify has already rendered for the page as soon as it loads.

select_item

Fires when a shopper clicks a product from a list.

How it fires: Listens for clicks on any link pointing to a product page, and looks up that product's details from the list it was clicked from (fetching them if needed).

add_to_cart

Fires when a shopper adds an item to their cart.

How it fires: Watches your theme's Add to Cart requests, however your theme sends them, and reads the cart's response to build the event.

view_cart

Fires when a shopper opens their cart page or cart drawer.

How it fires: Fires immediately on the cart page, and detects most themes' cart drawers opening (including Dawn's built-in drawer, with a fallback for other themes) before reading the current cart contents.

remove_from_cart

Fires when a shopper removes an item or lowers its quantity in the cart.

How it fires: Watches the same cart requests as Add to Cart, comparing the cart before and after the request to detect what was removed or reduced.

collection_sort

Fires when a shopper changes the sort order on a collection page.

How it fires: Listens for changes to your theme's sort dropdown.

view_search_results

Fires when a shopper views search results.

How it fires: Reads the search term from the page URL and the result count from Shopify's page data as soon as the search results page loads.

item_variant_select

Fires when a shopper picks a different size, color, or other option.

How it fires: Watches the page URL for variant changes — including themes that update the URL without a full page reload — with a fallback for themes that use a plain dropdown instead.

filter_click

Fires when a shopper applies or changes a collection filter.

How it fires: Watches the page URL for filter parameter changes as a shopper applies filters on a collection page.

grid_change

Fires when a shopper switches product grid layouts (e.g. 1-column vs. 2-column) on a collection page.

How it fires: Listens for clicks on your theme's grid or column layout toggle.

content_module

Fires once when a shopper scrolls a tagged content section into view.

How it fires: Uses the browser's built-in scroll-visibility detection on sections you've tagged in your theme. Unlike every other event on this page, this one requires a one-time manual markup change — see the Getting Started guide.

Checkout events (via Web Pixel)

Delivered via a secure Shopify Web Pixel extension. These are enabled automatically — no configuration required.

  • begin_checkoutFires when a shopper starts checkout.
  • add_shipping_infoFires when a shopper selects a shipping method.
  • add_payment_infoFires when a shopper enters payment details.
  • purchaseFires when an order is completed.

CSS-Targeting events

These use Google Tag Manager's own click and form-submission detection, matched against a CSS selector you configure on the Events page — no code runs from Ceres to detect them directly. Use the Theme Report to find a selector that reliably matches your theme's markup.

  • navigation_clickFires when a shopper clicks a navigation link.
  • cta_clickFires when a shopper clicks a call-to-action button or link.
  • accordion_expandFires when a shopper expands an accordion or toggle section.
  • email_actionFires when a shopper clicks a mailto: link.
  • phone_actionFires when a shopper clicks a tel: link.
  • form_submitFires when a shopper submits a form (e.g. search or newsletter signup).