Metric definitions
All default metrics Umami collects along with high level definitions.
Event metrics
Event metrics help identify a unique event for a user. Each event is stored as a unique UUID called an Event ID.
Website ID
A unique UUID value to identify your website included in the payload.
Hostname
Location hostname property included in the payload.
URL
URL pathname and search property combined included in the payload.
Referrer
Document referrer property included in the payload. If the referrer includes the hostname, the value is replaced by the previous URL.
Title
Document title property included in the payload.
Query parameters
Search property that is extracted from the URL after the payload is sent.
Session metrics
Session metrics help identify a unique session for a user. Each session is stored as a unique UUID called a Session ID.
Browser
Browser name extracted from the User-Agent.
Examples: Chrome, FireFox, iOS, Safari, Edge
OS
Operating system name extracted from the User-Agent.
Examples: Windows 10, macOS, Linux, Android, iOS
Device
Device name that is identified from the combination of OS and screen.
Examples: Laptop, desktop, mobile, tablet
Screen
Screen width and height property included in the payload.
Examples: 1920x1080, 1280x960
Language
Navigator language property included in the payload.
Examples: English, Chinese, German, French
Location metrics
Location metrics come from different sources depending on the headers. The IP address sending the request is used to gather these metrics, but is never stored.
Cloudflare: HTTP request headersVercel: Geolocation headersMaxMind: Geolite Database.
Country
Name of country following ISO-3166 standards.
Examples: United States, China, Germany, France
Region
Name of region (subdivisions) following ISO-3166-2 standards.
Examples: California, Ontario, Bayern, Île-de-France
City
Name of city.
Examples: San Francisco, Toronto, Munich, Paris
Calculated metrics
Calculated metrics are a combination of total and unique aggregates per website.
Views
The total number of events that were collected by your visitors.
Visits
Unique number of visits. A visit is a more granular range within a user session. A visit is calculated using a hash of the session ID and rotating salt that is rotated at the start of every hour. Visits are able to span across hourly intervals.
Visitors
Unique number of sessions. A session is calculated using a hash of data such as Website ID, hostname, User-Agent, etc and a rotating salt that is rotated at the start of every month.
Bounce rate
A bounce is defined when a visit has only 1 event. A user will enter the website, initially generating a view, then leaving. The bounce rate is calculated by dividing the total number of bounces by unique number of visits.
Visit duration
Total time spent on the website divided by unique number of visits. Total time is only calculated for visitors that visit more then one page. The difference between the first and last event create time per visit are summed into a duration time.