JavaScript events for wishlist and loyalty actions on the storefront. Use them in a custom script, GTM, or a Klaviyo listener.
Published guide: Wishlist events
Event names use the gatto-wl: prefix.
In the app: Integrations → Wishlist Events or Integrations → Loyalty Events.
Image_placeholder_1
| Event | When it fires |
|---|---|
gatto-wl:gwl-added-product |
A product is added to the wishlist. |
gatto-wl:gwl-deleted-product |
A product is removed from the wishlist. |
gatto-wl:gwl-added-wishlist |
Customer creates a new wishlist (only when Enable multiple wishlists is on). |
gatto-wl:gwl-deleted-wishlist |
Customer deletes a wishlist. |
gatto-wl:gwl-updated-wishlist |
Wishlist details (for example name) are updated. |
gatto-wl:gwl-changed-variant-dropdown |
Customer changes variant with the dropdown on the wishlist page or drawer. |
gatto-wl:gwl-add-to-cart |
Customer clicks Add to cart or Add all to cart on the wishlist page or drawer. |
gatto-wl:gwl-open-drawer |
Wishlist drawer opens. |
gatto-wl:gwl-close-drawer |
Wishlist drawer closes. |
gatto-wl:gwl-open-details-page |
Wishlist details page view opens. |
gatto-wl:gwl-close-details-page |
Wishlist details page view closes. |
gatto-wl:gwl-save-for-later |
Shopper moves a cart line to the wishlist (Save for later). |
Multi-list and multi-variant are merchant settings, available on all plans (not Premium-only):
Image_placeholder_2
Creating a list does not use wishlist addition quota. Saving a product (or an extra variant) does. Guests always use a single list.
| Event | When it fires |
|---|---|
gatto-wl:loyalty-panel-open |
Rewards panel opens. |
gatto-wl:loyalty-panel-close |
Rewards panel closes. |
gatto-wl:loyalty-reward-redeemed |
Shopper redeems a reward and receives a discount code. |
gatto-wl:loyalty-earn-claimed |
Shopper successfully claims an earn action (social, birthday reward, and similar). |
gatto-wl:loyalty-referral-shared |
Shopper copies or shares their referral link. |
gatto-wl:loyalty-balance-updated |
Points balance changes after redeem, claim, birthday reward, or a purchase-earn toast. |
Image_placeholder_3
Server-side Klaviyo metrics (points earned on order, tier upgrade email Flows, and similar) are separate from these browser events.
window.addEventListener("gatto-wl:gwl-changed-variant-dropdown", ({ detail }) => {
console.log("Event triggered:", detail);
});
{
"wishlistId": "1",
"productHandle": "selling-plans-ski-wax",
"variantId": "49824039797022"
}
For Klaviyo Flows from client-side wishlist actions, see Klaviyo storefront events.