> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Events: Track Your Own Events

> Track custom event counts fired from your site. Measure user interactions, feature usage, and custom milestones to optimize your e-commerce funnel.

<Tip>
  The total number of custom events tracked on your store via the Upstack pixel.
</Tip>

## Formula

<Info>
  **Custom Events** = **COUNT** ( Custom Events )
</Info>

### Formula Components

| Metric            | Definition                                                                                |
| ----------------- | ----------------------------------------------------------------------------------------- |
| **Custom Events** | Each custom event fired via the Upstack pixel `track` method with your defined event name |

| Metadata        |                         |
| --------------- | ----------------------- |
| **Type**        | Number                  |
| **Data Source** | [Upstack Pixel](/pixel) |
| **Aggregation** | Count                   |

***

## Example

Your outdoor gear store tracked **8,432 custom events** last week for key user interactions:

| Event Name              | Count | Share |
| ----------------------- | ----- | ----- |
| size\_guide\_opened     | 3,150 | 37%   |
| video\_played           | 2,890 | 34%   |
| wishlist\_added         | 1,560 | 19%   |
| store\_locator\_clicked | 832   | 10%   |

***

## How It Works

Custom Events count each time your site fires a custom event via the Upstack pixel. You define the event name and properties when implementing the tracking call. Each event is counted individually regardless of the visitor or session.

***

## When to Use

| Scenario                    | Action                                                         |
| --------------------------- | -------------------------------------------------------------- |
| Track feature engagement    | Measure how often users interact with specific features        |
| Monitor user milestones     | Count key actions like video plays or guide downloads          |
| Compare campaign variations | Track custom events tied to A/B test interactions              |
| Build custom funnels        | Combine custom events with standard events for deeper analysis |

***

## Related Metrics

| Metric                                                              | Relationship                                  |
| ------------------------------------------------------------------- | --------------------------------------------- |
| [Total Events](/reference/metrics/funnel/engagement/total-events)   | Includes custom events in overall event count |
| [View Contents](/reference/metrics/funnel/engagement/view-contents) | Standard event for product page views         |
| [Add to Carts](/reference/metrics/funnel/engagement/add-to-carts)   | Standard event for cart additions             |

[See all Engagement metrics →](/reference/metrics/funnel/engagement)