Umami Custom Events Not Showing

Share
Workaround available Web Updated November 13, 2026Based on 3 user reportsHow we research

Quick answer

Umami records events from data-umami-event attributes or umami.track() calls, and they appear on the website's Events page, not the main overview. Check the event name (max 50 characters), that the element is actually clicked, and that a request fires to /api/send.

Most likely fix: Check the right report

How to fix it

Try these in order — the most common fix is first.

  1. 1. Check the right report

    1. Open the website in Umami and go to the Events page
    2. Use the Properties tab for custom data
    3. Widen the date range and clear filters
    Did this fix it?
  2. 2. Validate the markup

    1. Use data-umami-event="Signup button" on the clickable element itself
    2. Keep names under 50 characters
    3. Add properties as data-umami-event-plan="pro"
    Did this fix it?
  3. 3. Fire events from JavaScript safely

    1. Call umami.track('Event name', { key: value }) only after the script has loaded (check window.umami exists)
    2. Use the JS method when you need numbers, booleans or dates
    3. Click the element and confirm a request to /api/send in DevTools > Network
    Did this fix it?
  4. 4. Track outbound links

    1. Add data-umami-event and a URL property to each external link, or
    2. Add a click listener that calls umami.track for links whose host differs from location.host
    Did this fix it?

Symptoms

Clicks on tagged buttons or links don't appear, event properties are missing, or events show on one page but not the Overview.

Why it happens

  • Looking on Overview instead of the Events page
  • Event name missing or longer than 50 characters
  • Sending event data without an event name
  • umami.track() called before the script has loaded
  • Expecting number or boolean properties from data attributes (they're stored as strings)
  • Ad blocker or self-exclusion blocking the request

This guide also covers

  • umami events not showing
  • umami track event not working
  • data-umami-event not working
  • umami outbound links

Still not working?

If Umami keeps failing, you're not alone. See every Umami problem users report or the alternatives people switch to.

Done fighting Umami? Our small team builds your own Umami alternative, made for how you work. On your domain or hosted by us. Price agreed together.

Get a quote
Fixed it? Share this guide

The same problem in other apps

All missing or lost data guides →

Other Umami errors

All 12 Umami errors and fixes →