Tracking

Event data

Attach custom properties to tracked events in Umami with data attributes or umami.track(), then view them on the Events page.

Available since v2.0.0

Event data lets you attach custom properties to your tracked events for deeper analysis. For example, you can track which product was purchased, what button variant was clicked, or any other contextual information relevant to your events.

Umami allows you to attach dynamic data to your events using two methods:

Data attributes - Add data-umami-event-* attributes directly to HTML elements. Values are always stored as strings.
Tracker functions - Use umami.track() with a data object. Supports strings, numbers, booleans, arrays, and objects.

Examples#

Track a button click with product details using data attributes:

<button
  data-umami-event="add-to-cart"
  data-umami-event-product="t-shirt"
  data-umami-event-price="29.99"
>
  Add to Cart
</button>

Or using the tracker function:

umami.track('add-to-cart', { product: 't-shirt', price: 29.99 });

Accessing event data#

Open a website and go to the Events page. Your custom event data can be accessed under the Properties tab.

Event data is displayed as a breakdown of each property name and its values, along with the total count for each value. Use this to understand how your custom data is distributed across events.

To narrow the results to specific property names and values, see Filtering.