How It Works
The Umami tracker is a lightweight JavaScript snippet that runs in your visitors’ browsers. It automatically tracks page views and can be configured to track custom events.Automatic Tracking
Page views are tracked automatically when the script loads and on navigation changes in single-page applications.
Event Tracking
Track user interactions like button clicks, form submissions, and custom events using HTML attributes or JavaScript.
User Identification
Identify users and track their journey across sessions with the identify function.
Privacy First
Respects Do Not Track settings, no cookies required, and all data is anonymized.
What Data Is Collected
Umami automatically collects the following information on each page view:| Property | Description | Example |
|---|---|---|
hostname | The website’s hostname | analytics.umami.is |
language | Browser language | en-US, fr-FR |
referrer | Page referrer URL | https://google.com |
screen | Screen dimensions | 1920x1080 |
title | Page title | Getting Started - Umami |
url | Current page URL | /docs/getting-started |
website | Your website ID | b59e9c65-ae32-47f1-8400-119fcf4861c4 |
All data is extracted from the browser’s standard APIs (
window.location, window.navigator, window.screen) and does not include any personally identifiable information.Privacy Features
Umami is built with privacy as a core principle:No Cookies
No Cookies
Anonymous Data
Anonymous Data
All data collected is anonymized. No personal information like IP addresses is stored.
Do Not Track Support
Do Not Track Support
The tracker respects the Do Not Track (DNT) browser setting when configured with the
data-do-not-track attribute.GDPR Compliant
GDPR Compliant
Umami is designed to be GDPR compliant out of the box, with no personal data collection.
Core Features
Automatic Page View Tracking
Once installed, the tracker automatically:- Records page views on initial load
- Tracks navigation in single-page applications (SPAs)
- Monitors URL changes via History API
Custom Event Tracking
Track user interactions in two ways:- HTML Attributes
- JavaScript API
Add tracking to any element without writing JavaScript:
User Identification
Track users across sessions and associate events with specific users:Getting Started
Install the tracking script
Add the Umami script tag to your website’s HTML.Learn more about script installation →
Configure tracking options
Customize the tracker behavior with data attributes.View all configuration options →
Track custom events
Add event tracking to capture user interactions.Learn about event tracking →
Next Steps
Script Installation
Learn how to install the tracking script on your website
Tracker Configuration
Customize tracker behavior with configuration options
Event Tracking
Track custom events and user interactions
Tracker Functions
Use the JavaScript API for advanced tracking