---
title: "Superfans App Events in Klaviyo"
description: "This guide explains how to manage, map, and create Metrics."
url: https://help.superfans.io/en/articles/94-superfans-app-events-in-klaviyo
collection: "Klaviyo"
updated: 2026-11-12
language: en
---

# Superfans App Events in Klaviyo

This guide explains how to manage, map, and create Metrics.

Your Superfans app sends every shopper action, such as opening a screen, adding a product to the cart or completing an order, to Klaviyo as an event. You can see these events on each customer's Klaviyo profile and use them in Klaviyo dashboards, segments and flows.  
  
How to track an event for the first time

1.  Go to **Analytics > Dashboards** and click **Create Dashboard**.
    
2.  Enter a **Dashboard Name** and click **Create Dashboard**.  
    
    ![The Analytics > Dashboards screen lists dashboards, with red outlines highlighting the selected Dashboards navigation item and the Create dashboard button. Visible: Dashboards, Create dashboard, Name, Created, Updated, Business review.](https://staticfiles.gleap.io/ghelparticle/458xsxMlt9ypwZZ1MH6gPQ2g2T7uG70rNz4JpBuYweosN9piqtPGGxxIDX8Q7zvXs5rExu6ijjN.png)
    
3.  Give a name for the dashboard in the name field, Click **Add Data View**, then **Create from scratch**.
    
    ![Analytics > Dashboards screen for dashboard “test” shows an empty-state prompt to add a data view and a revenue-increase survey banner. Visible: Your total revenue increased: 🎉 How would you rate your experience?, Dashboards, test, Social, Service, Audience.](https://staticfiles.gleap.io/ghelparticle/PiCtjOAhLcSd1WvAclwZK4Wv74BEWJ7crCV4WgvgNop7mNUzC7YhFt9K1tzuCx1RPA4719TkNjB.png)
    
      
    
    ![](https://staticfiles.gleap.io/ghelparticle/2ZuGzrM6k7SicRaxBdKMjp95cuTj6F48TzWsuPFjdpAV3hc0grYqmFEJScic0FVyOP6aqp0CNFB.png)
    
4.  Under **Choose a metric**, pick the event from the **Select a metric** dropdown.  
      
    
    ![A “Create from scratch” dashboard card modal lets users choose a metric, grouping, filter, and visualization type; Table is selected. Visible: Create from scratch, Choose a metric:, Select a metric, Counts, Group by:, (Optional).](https://staticfiles.gleap.io/ghelparticle/4v5XEiwhd3C75Mey73lEd1OZQL7desHUsd6B8M2LLuwy2qeQXeDxH5EeuTVmVX3GSJxIJ9QMrtl.png)
    
5.  Optional: use **Group by** or **\+ Add Filter** to split or narrow the data.
    
6.  Select **Table** (or **Line graph**, **Bar graph** or **Number**) and click **Add Card**.
    

**Using Group by and filters:** Group by is optional. You can group by any property the event carries and add a filter to narrow it. For example, group by City and filter City to Chennai to see how many times the event fired for shoppers in Chennai.

## How to see an event's details

1.  Open a customer's profile in Klaviyo and find the event in the activity feed.
    
2.  Click the **three dots** next to the event, then click **Activity details**.
    

![Audience profile Details screen for matrey@superfans.io, with channel consent and event activity; red boxes highlight Audience in the sidebar and Activity details in an event menu. Visible: Audience, Activity details, All profiles, matrey@superfans.io, Details, Channel consent.](https://staticfiles.gleap.io/ghelparticle/oU1cfMFxExjGmtXR5JMBErWEuOqC94M7ZhtH96tq8zEFhKT11ZCTODqdJj2vVD6SbTcGhNvyXsF.png)

3.  Switch between **Pretty** (easy to read) and **JSON** (raw data).  
      
    
    ![Activity details modal showing timestamped activity data, with a red box highlighting the Pretty tab beside JSON. Visible: Activity details, This activity was timestamped at, and was recorded on, Here is the activity data:, Pretty, JSON.](https://staticfiles.gleap.io/ghelparticle/GjQZETsWAzMZXbPlmXtDCYMV2hhV5SVuLfAa4wPcPKxrhJuTdXychTofyXvZ0zLaq1qMukysGWi.png)
    

Alongside its main parameter, every Superfans app event also shows the App, OS, Device and Push Token details, and most events also show the store name.

## Superfans app events

<table data-id="466718da-2cbe-4e3f-96cb-662c8eb1d739" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p data-id="5c49a2f2-b54a-4fe8-9552-c27b309bcc53">Event</p></th><th colspan="1" rowspan="1"><p data-id="0ee7aead-55f1-46e6-abeb-7399f9f3cf32">What it tracks</p></th><th colspan="1" rowspan="1"><p data-id="cb1ea423-83b9-414c-84d4-f4025206d75d">Main parameter (example)</p></th></tr><tr><td colspan="1" rowspan="1"><p data-id="c1c84604-d4cd-42f7-8072-64a032532c79">Logged In</p></td><td colspan="1" rowspan="1"><p data-id="750871f2-b8a4-40a9-be33-33e43b0c9c88">Shopper signs in</p></td><td colspan="1" rowspan="1"><p data-id="6e584fa5-4e5f-47eb-9e40-c525d677185e">Customer Id</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0525f5fc-b6a0-4b05-8913-0a1f40db4444">Logged Out</p></td><td colspan="1" rowspan="1"><p data-id="30baed0e-426a-4abd-ae07-58b278b1850a">Shopper signs out</p></td><td colspan="1" rowspan="1"><p data-id="4a564a8a-dc73-46d1-9c55-d5b3af57ffd4">Customer Id and Email Id</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="fcb82a05-929e-4613-8473-4b1ace0a2768">View Page</p></td><td colspan="1" rowspan="1"><p data-id="13797894-b245-423f-a89d-28edf87c95d2">Shopper opens any screen</p></td><td colspan="1" rowspan="1"><p data-id="9a5b07c5-d29a-416e-8e5c-31f43b42321e">Page Name (cart)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4956a3f1-ec42-4469-9e48-df4fee2ca001">Bottom Bar Switched</p></td><td colspan="1" rowspan="1"><p data-id="7a59846c-395a-4ba2-b358-72d77188875a">Shopper taps a bottom bar tab</p></td><td colspan="1" rowspan="1"><p data-id="8b0c105b-04e8-4a3c-bc09-3d80a3750acf">page (Account)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4552907c-f434-435a-828b-b7af5bbc0648">Top Nav Switched</p></td><td colspan="1" rowspan="1"><p data-id="2afb91a6-6c0d-42b0-abc0-1a4b77324bec">Shopper taps a top nav tab</p></td><td colspan="1" rowspan="1"><p data-id="6a090afb-c0f6-452d-a47b-34ca6cf684cf">page (Clothing)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4c8dc81b-d665-4b61-b3b4-a97b59fbfc9f">Side Nav Opened</p></td><td colspan="1" rowspan="1"><p data-id="db92a6b9-030e-4bf7-915b-d5bde6f323d4">Shopper opens the side menu</p></td><td colspan="1" rowspan="1"><p data-id="c2999052-b85c-47a5-bd59-331169051c17">page (always Side Navigation Menu)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="adad5d4e-e281-4229-af9c-e5bd30752f65">Side Nav Closed</p></td><td colspan="1" rowspan="1"><p data-id="3abd4b26-ac59-4745-8664-47e6df57819b">Shopper closes the side menu</p></td><td colspan="1" rowspan="1"><p data-id="79cd3c95-787a-4604-b472-6e8b5eed2a25">page (always Side Navigation Menu)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4a80619b-f99e-4c9a-8060-7c16e9f55fd5">Viewed Collection</p></td><td colspan="1" rowspan="1"><p data-id="7995bc52-3439-499e-8d23-53e0f8bf0cda">Shopper opens a collection</p></td><td colspan="1" rowspan="1"><p data-id="67a8dd88-57a3-4006-bb9f-1c9014943d88">Collection Name</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="fc2da06c-a5fc-493d-a159-c09166a391fc">Collection Filtered</p></td><td colspan="1" rowspan="1"><p data-id="10777ad4-35af-46a0-be79-7425f8b6855f">Shopper filters a collection</p></td><td colspan="1" rowspan="1"><p data-id="d5035212-79a0-4469-8d5f-93d37852301c">Filter (Size 2, Brown) and Collection Name (New In)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="ca2e8442-f287-4264-b782-7337f60b5009">Collection Sorted</p></td><td colspan="1" rowspan="1"><p data-id="6dc7a8b8-84be-4991-a29a-012ba1751543">Shopper sorts a collection</p></td><td colspan="1" rowspan="1"><p data-id="544ef2dd-ea95-4928-98a0-2454469d627c">Sort (LATEST) and Collection Name (All Towels &amp; Robes)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="90bb69a8-46bf-4847-8be7-5aa081c71355">Search</p></td><td colspan="1" rowspan="1"><p data-id="54640a39-d5bd-4b45-beb7-f99d98c8907a">Shopper searches</p></td><td colspan="1" rowspan="1"><p data-id="51e02af2-97a1-4ed9-8f71-6b59399d780b">Search Keyword (Christmas)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="349cf82f-324b-4593-8a99-d828bf264af8">Search Result Filter</p></td><td colspan="1" rowspan="1"><p data-id="31cd1367-6d39-4235-b646-c47101971b3d">Shopper filters search results</p></td><td colspan="1" rowspan="1"><p data-id="b84e07ae-7400-4a96-827d-b15f00124166">Filter (Blue, Brown) and Search Keyword (Christmas)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="6eae912f-a2ae-4848-bde3-c2552be3e30f">Viewed Product</p></td><td colspan="1" rowspan="1"><p data-id="86fffbf3-1c20-46aa-802d-b8a37a2df643">Shopper opens a product page</p></td><td colspan="1" rowspan="1"><p data-id="27d9753a-cb21-4330-b3fa-f29fbfa9f535">Product Name (Opaque 80 Den Tights - Black)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="661f1b9b-c647-434f-8533-3208fde99e91">Variant Changed</p></td><td colspan="1" rowspan="1"><p data-id="af357a3d-50cc-4540-ade9-4a0b0769ca56">Shopper switches size or color on a product page</p></td><td colspan="1" rowspan="1"><p data-id="da31fcb8-a17d-45f6-8f68-d784d14ab288">—</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="2189e4f7-2c52-45fe-bb03-d25765cfbaa2">Added to Wishlist</p></td><td colspan="1" rowspan="1"><p data-id="c1266a57-9ed5-4f9b-a3d1-ed1a1ce484d0">Shopper saves a product</p></td><td colspan="1" rowspan="1"><p data-id="67d98901-e8f8-4cd0-90fe-8c17a2877cf2">ProductName (Pattern Tights - Can't Catch Me)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4ca0bcaa-36f9-4ba0-af18-65b9c58d585c">Removed From Wishlist</p></td><td colspan="1" rowspan="1"><p data-id="6864fe7d-cfd6-4384-bcea-0d4672bf4bf3">Shopper removes a saved product</p></td><td colspan="1" rowspan="1"><p data-id="4a7c1396-23f1-46c6-be73-a0832ad7e201">ProductName (Wool Lace Tights - Ditsy Diamond - Black)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4e78d296-4bbe-4963-b68f-4e53034d0eb1">Added to Cart</p></td><td colspan="1" rowspan="1"><p data-id="03db8f88-c745-4e3e-a98d-9c753d621cfb">Shopper adds one product to the cart from a product page (value = that product's price)</p></td><td colspan="1" rowspan="1"><p data-id="b83c13b6-f66d-42d2-8a29-eddad3a1d986">Product Name (Wool Lace Tights - Ditsy Diamond - Cherry)</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c99e662b-209f-47ca-ad58-c79aeeeea498">Removed from Cart</p></td><td colspan="1" rowspan="1"><p data-id="3931fb50-e4f0-4e46-a0ce-171fa4f81d15">Shopper removes a product from the cart</p></td><td colspan="1" rowspan="1"><p data-id="a2d2cfdb-6aa6-4d0f-b343-a22a19bbd9a6">Product Name (Pencil Skirt - Black (V2))</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a60ef973-623e-4b75-aa92-a1a87bee1a61">Track Cart</p></td><td colspan="1" rowspan="1"><p data-id="5c778663-664f-4e1f-a405-0ee9f3fd6a64">Everything in the shopper's cart, recorded each time they open the cart screen, where they increase or decrease item quantities (value = cart total)</p></td><td colspan="1" rowspan="1"><p data-id="279e87dc-9904-449d-b382-84aedf324ad5">$value (cart total) and Line Items</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="1ba17925-ee11-4eaa-b9fe-7a42fffc33bf">Started Checkout</p></td><td colspan="1" rowspan="1"><p data-id="b679b6eb-f812-4a7d-9557-94866199548d">Shopper taps checkout</p></td><td colspan="1" rowspan="1"><p data-id="afd22d54-b56b-4ea7-aa0e-ed998e78f873">$value (amount about to be paid) and Line Items</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="53a788c7-1329-4fcf-9b75-57e4ef4d964e">Purchased</p></td><td colspan="1" rowspan="1"><p data-id="17fcab16-6991-4113-a424-9a0653f755f2">Shopper completes an order</p></td><td colspan="1" rowspan="1"><p data-id="bc329250-a3a3-4386-a6c6-29a8e25a2f36">$value (order total paid) and Line Items</p></td></tr></tbody></table>

**Reading the Filter parameter:** Filter arrives as code. Look only for each label (the filter's name) and its value (what the shopper picked). For example, "label":"Size" … "value":"Size 2" means the shopper filtered to Size 2. Ignore the rest of the code.

## Custom events

Besides the standard Superfans app events above, your app can send its own custom events to Klaviyo, for example **Quiz Completed** when a shopper finishes a style quiz. Custom events are unique to your app and are usually triggered from custom blocks or Superfans SDK actions.

Once a custom event fires, it appears in the customer's activity feed and in the **Select a metric** dropdown, so you can use it in dashboards, segments and flows like any other event.

**How to set up a custom event:** Reach out to your Superfans strategic account manager with the shopper action you want to track and what you plan to use it for in Klaviyo. Our team will set up the custom event in your app for you.
