Umami Custom Events Not Showing
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. Check the right report
- Open the website in Umami and go to the Events page
- Use the Properties tab for custom data
- Widen the date range and clear filters
Did this fix it?2. Validate the markup
- Use data-umami-event="Signup button" on the clickable element itself
- Keep names under 50 characters
- Add properties as data-umami-event-plan="pro"
Did this fix it?3. Fire events from JavaScript safely
- Call umami.track('Event name', { key: value }) only after the script has loaded (check window.umami exists)
- Use the JS method when you need numbers, booleans or dates
- Click the element and confirm a request to /api/send in DevTools > Network
Did this fix it?4. Track outbound links
- Add data-umami-event and a URL property to each external link, or
- 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 quoteThe same problem in other apps
All missing or lost data guides →
- Plausible Custom Events and Goals Not Showing (Plausible Analytics)
- PostHog Events Not Showing Up (PostHog)
- Fathom Events Not Showing Up (Fathom Analytics)
Other Umami errors
- Umami Not Tracking Visitors (No Data Showing)
- Umami Blocked by Ad Blockers (uBlock Origin, Brave)
- Umami v3 Upgrade: MySQL Not Supported
- Umami Migration Failed (Prisma P3009 / P3018 Error)
- Umami Docker "Unable to Connect to the Database"
- Umami Default Login and Forgot Password Reset
- Umami Shows Wrong Country or "Unknown" Location
- How to Exclude Your Own Visits in Umami