> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Umami
- URL: https://blog.esadax.com/en/umami-en-8/
- Published: 2026-11-15T05:09:56.000Z
- Updated: 2026-11-15T05:09:56.000Z
- Author: Esadax 
- Tags: #tr-apps-03-catalog-umami, #en, #mdx-imported, Apps

# What is Umami?

Umami is a lightweight, open-source, privacy-focused web and product analytics platform designed to help website owners and developers understand visitor behavior without relying on traditional tracking cookies or invasive advertising technologies.

It provides a centralized dashboard for monitoring website traffic, pageviews, visitors, referral sources, user interactions, and conversion performance.

Unlike conventional analytics platforms that depend on extensive visitor profiling, Umami focuses on collecting useful aggregate statistics while minimizing personal data collection.

The platform also supports custom event tracking, conversion funnels, user retention analysis, campaign attribution, session recordings, and heatmaps.

Umami uses a lightweight tracking script that can be integrated into websites and web applications with minimal configuration.

Its self-hosted architecture allows organizations to operate their own analytics infrastructure and maintain control over collected data.

Umami is particularly suitable for businesses, developers, SaaS companies, publishers, and privacy-conscious website owners looking for a straightforward alternative to traditional web analytics platforms.

## History of Umami

Umami is an open-source analytics project originally created by Mike Cao.

The project was developed to provide a simpler and more privacy-conscious alternative to traditional website analytics services.

Its initial focus was on website traffic statistics, including pageviews, visitors, referral sources, and browser information.

Over time, Umami expanded into a broader product analytics platform with custom events, conversion funnels, retention analysis, experimentation-related capabilities, and additional behavioral insights.

The application is developed primarily using TypeScript and React, with a backend that uses Node.js and PostgreSQL.

Umami is distributed under the MIT license, allowing individuals and organizations to use, modify, and deploy the software according to its terms.

## Key Features of Umami

Umami provides a comprehensive collection of features for monitoring websites and understanding product usage.

- **Website Analytics:** Monitor visitors, pageviews, sessions, and website engagement.
- **Privacy-Focused Tracking:** Collect analytics without traditional tracking cookies or cross-site advertising profiles.
- **Real-Time Analytics:** Monitor current website activity and incoming traffic.
- **Traffic Sources:** Identify referral websites, search engines, and campaign sources.
- **Visitor Insights:** Analyze browsers, operating systems, device types, and approximate geographical locations.
- **Custom Event Tracking:** Record important interactions such as registrations, purchases, downloads, and button clicks.
- **Conversion Funnels:** Identify where visitors abandon important workflows.
- **User Retention:** Measure how frequently visitors return to a website or application.
- **User Segmentation:** Group visitors according to behavioral criteria and available properties.
- **Session Replay:** Review recorded interactions to understand user behavior.
- **Heatmaps:** Visualize where visitors interact with website elements.
- **UTM Campaign Tracking:** Measure traffic generated by marketing campaigns.
- **Goal Tracking:** Monitor important business and application objectives.
- **Revenue Analytics:** Associate events with monetary values and analyze generated revenue.
- **Attribution:** Understand which marketing channels contribute to conversions.
- **Custom Dashboards:** Organize analytics reports into configurable dashboards.
- **Shareable Reports:** Share website analytics through controlled public links.
- **API Access:** Retrieve analytics information through programmatic interfaces.
- **MCP Integration:** Allow compatible AI assistants to query analytics through a read-only interface.
- **Multi-Website Management:** Manage analytics for multiple websites from one account.

## Use Cases

Umami is suitable for website owners, developers, product teams, and organizations that need meaningful analytics without invasive visitor tracking.

Common use cases include:

- **Business Websites:** Monitor traffic, visitor engagement, and popular pages.
- **SaaS Applications:** Understand user behavior, feature adoption, and product retention.
- **Ecommerce Platforms:** Track purchases, conversion rates, revenue, and customer interactions.
- **Blogs and Publications:** Identify popular articles and understand referral sources.
- **Marketing Campaigns:** Measure the effectiveness of advertising and promotional activities.
- **Landing Pages:** Analyze visitor behavior and optimize conversion rates.
- **Developer Portfolios:** Monitor traffic and engagement across personal websites.
- **Mobile Applications:** Track user interactions through supported SDKs.
- **Privacy-Conscious Analytics:** Collect useful website statistics without conventional cookie-based tracking.
- **Product Development:** Evaluate new features and identify opportunities for improvement.
- **Business Reporting:** Create centralized dashboards for monitoring important metrics.
- **Internal Applications:** Monitor usage of private business applications.

## Benefits of Umami

- Lightweight and fast analytics tracking
- Open-source software distributed under the MIT license
- Privacy-focused visitor measurement
- No traditional tracking cookies
- No cross-site advertising tracking
- Real-time website statistics
- Custom events and conversion tracking
- Advanced traffic and behavior analysis
- Session replay and heatmaps
- Campaign attribution and UTM tracking
- User retention and cohort analysis
- Revenue reporting
- Custom dashboards
- REST API and developer integrations
- AI assistant integration through MCP
- Self-hosted deployment and data ownership
- Supports multiple websites from a centralized interface

## How to Install Umami

To install Umami through Esadax, follow these steps:

1. Purchase the application through Esadax.
2. After purchasing, provide the required application configuration details.
3. Configure the public URL used to access the analytics dashboard.
4. Complete the initial administrator account setup.
5. Access Umami through its assigned application URL.
6. Sign in to the administration interface.
7. Create a new organization or workspace if required.
8. Add the websites you want to monitor.
9. Copy the tracking script generated for each website.
10. Add the tracking script to the corresponding website.
11. Verify that incoming events appear in the Umami dashboard.
12. Configure custom events and conversion goals.
13. Create dashboards and reports to monitor website performance.

Once configured, Umami starts collecting website analytics and presenting the results through its dashboard.

## Website Analytics

Website analytics is the foundation of Umami.

The platform collects website activity and transforms it into understandable reports that help owners evaluate how visitors discover and interact with their websites.

The analytics dashboard provides information such as:

- Unique visitors
- Pageviews
- Sessions
- Average visit duration
- Bounce rate
- Pages per visit
- Referral sources
- Search engine traffic
- Browser information
- Operating systems
- Device categories
- Approximate visitor locations
- Entry and exit pages

Users can filter reports according to date ranges, websites, events, and available visitor properties.

The interface also supports comparisons between different reporting periods.

For example, a business can compare website traffic between two months to understand whether recent content and marketing changes have improved engagement.

## Real-Time Visitor Monitoring

Umami includes real-time analytics that allow website owners to monitor incoming traffic.

The real-time dashboard provides an overview of current activity and recently recorded interactions.

Administrators can use this functionality to:

- Monitor active website traffic
- Observe incoming pageviews
- Identify popular pages
- Review referral sources
- Monitor campaign activity
- Verify tracking integrations
- Observe newly recorded events

Real-time monitoring is particularly useful when launching marketing campaigns, publishing new content, or testing website changes.

It also provides a convenient way to verify that the tracking script is correctly installed and sending information to the analytics server.

## Tracking Script and Event Collection

Umami uses a lightweight JavaScript tracking script to collect website activity.

Once installed, the script automatically records supported interactions and sends analytics information to the configured Umami instance.

For example, a website can include the following tracking script:

```html
<script
  defer
  src="https://analytics.example.com/script.js"
  data-website-id="YOUR-WEBSITE-ID">
</script>

```

The tracking script supports automatic pageview collection and can also capture supported interactions.

For more specific analytics requirements, developers can send custom events through JavaScript or HTML data attributes.

Examples of trackable events include:

- User registration
- Login activity
- Button clicks
- Form submissions
- File downloads
- Product purchases
- Subscription creation
- Checkout completion
- Contact requests

Custom event properties can provide additional context about the interaction.

For example, an ecommerce application can associate a purchase event with an order value, product identifier, and currency.

This makes it possible to create reports that go beyond basic pageview statistics.

## Custom Events and Conversion Tracking

Umami supports custom event tracking for measuring specific actions within websites and applications.

Events can be recorded using HTML attributes or the JavaScript tracking interface.

For example, a registration button can be tracked using:

```html
<button data-umami-event="signup">
  Create Account
</button>

```

When a visitor interacts with the button, Umami records the corresponding event.

Developers can also send custom events programmatically:

```javascript
umami.track('purchase', {
  product: 'Premium Plan',
  value: 49
});

```

Custom events can be used to measure:

- Account registrations
- Subscription upgrades
- Purchases
- Downloads
- Form submissions
- Feature interactions
- User engagement
- Application-specific activities

Events can include additional properties, allowing reports to distinguish between different products, plans, or actions.

This functionality is particularly useful for SaaS applications and businesses that need to measure conversions beyond simple website traffic.

## Conversion Funnels and User Journeys

Umami provides funnel analysis for understanding how visitors progress through predefined sequences of events.

Funnels help identify where users abandon important workflows.

For example, an ecommerce funnel might contain:

1. Product page viewed.
2. Product added to cart.
3. Checkout started.
4. Payment completed.
5. Order confirmed.

Umami can display the number of users reaching each stage and identify where the largest drop-offs occur.

User journey analysis provides additional insight into the paths visitors take while navigating a website.

These capabilities help development and marketing teams:

- Identify registration problems.
- Improve checkout workflows.
- Understand navigation patterns.
- Evaluate landing page performance.
- Identify ineffective calls to action.
- Improve overall conversion rates.

## User Retention and Cohort Analysis

Umami includes retention analysis for measuring how frequently visitors return to a website or application.

Retention reports organize visitors into cohorts based on their initial activity and measure subsequent visits.

This helps teams understand whether users continue engaging with a product after their first interaction.

Retention analysis can be used to evaluate:

- Customer engagement
- Returning visitors
- Product adoption
- Content performance
- Subscription activity
- Long-term audience growth

Cohorts can also be used to compare groups of visitors according to shared behavioral properties.

For example, a SaaS business can compare returning users who activated a particular feature with those who did not.

This helps identify which product experiences contribute to long-term engagement.

## Session Replay and Heatmaps

Umami provides behavioral analysis tools that help developers understand how visitors interact with website interfaces.

### Session Replay

Session replay reconstructs supported user interactions so developers can investigate browsing behavior.

It can help identify:

- Navigation difficulties
- Unexpected interactions
- Form usability issues
- Interface problems
- Checkout interruptions
- User experience friction

Recordings provide additional context for understanding issues that may not be apparent from aggregate analytics alone.

### Heatmaps

Heatmaps provide a visual representation of visitor interactions with website elements.

They help identify areas receiving the most interaction and highlight interface sections that may need improvement.

Typical use cases include:

- Evaluating button placement
- Understanding navigation engagement
- Reviewing landing page interactions
- Identifying overlooked content
- Improving page layouts
- Optimizing calls to action

Both features should be configured with appropriate privacy controls to prevent sensitive information from being recorded.

## UTM Campaign Tracking

Umami supports UTM tracking for measuring traffic generated by marketing campaigns.

UTM parameters are additional values included in URLs to identify the source and characteristics of incoming traffic.

Common UTM parameters include:

| Parameter     | Description                                                                   |
| ------------- | ----------------------------------------------------------------------------- |
| utm\_source   | Identifies the source of the traffic, such as a newsletter or social network. |
| utm\_medium   | Identifies the marketing medium, such as email or paid advertising.           |
| utm\_campaign | Identifies the specific marketing campaign.                                   |
| utm\_content  | Differentiates advertisements or links within a campaign.                     |
| utm\_term     | Identifies relevant search keywords or advertising terms.                     |

For example:

`https://example.com/pricing?utm_source=newsletter&utm_medium=email&utm_campaign=launch`

Umami uses these parameters to organize incoming campaign traffic and provide attribution reports.

This allows businesses to compare the performance of marketing channels and identify which campaigns generate the most meaningful engagement.

## Goals and Revenue Analytics

Umami includes goal tracking for monitoring important website objectives.

Goals allow administrators to define measurable outcomes using pageviews or custom events.

Examples include:

- Successful account registrations
- Contact form submissions
- Newsletter subscriptions
- Product purchases
- File downloads
- Subscription upgrades

Revenue analytics extends event tracking by associating monetary values with user interactions.

Businesses can use revenue reports to understand how different pages, campaigns, and visitor segments contribute to generated revenue.

This is particularly useful for ecommerce platforms and subscription-based applications.

## Custom Dashboards and Reporting

Umami provides customizable dashboards for organizing analytics information.

Users can create boards containing selected reports and visualizations.

Available reporting elements include:

- Traffic statistics
- Pageview trends
- Visitor comparisons
- Event reports
- Conversion funnels
- Retention analysis
- UTM performance
- Revenue metrics
- Attribution reports
- Custom insights

Different dashboards can be created for marketing, development, management, and product teams.

This allows each team to focus on metrics relevant to its responsibilities without navigating unrelated reports.

Umami also supports sharing dashboards and website statistics through configurable access links.

## Multi-Website Management

Umami allows administrators to manage multiple websites from a centralized analytics account.

Each website receives its own tracking identifier and analytics configuration.

This makes it possible to separate reporting for different domains, applications, and projects.

Multi-website management is useful for:

- Agencies managing multiple customer websites
- Businesses operating several domains
- SaaS providers monitoring multiple applications
- Developers managing personal projects
- Organizations separating internal and public websites

Administrators can organize websites according to their reporting and access requirements.

The available website and team permissions depend on the configured edition and account privileges.

## API and Developer Integrations

Umami provides a REST API that allows external applications to retrieve analytics information and interact with supported application resources.

The API can be used to build custom reporting interfaces and connect Umami with other business systems.

Common integration scenarios include:

- Retrieving website statistics
- Querying pageview information
- Accessing event data
- Building custom dashboards
- Automating analytics reports
- Integrating website metrics into administrative applications
- Monitoring conversion performance
- Generating periodic business reports

Umami also provides SDK integration options for different application environments.

Supported development environments include:

- JavaScript
- React
- Next.js
- Node.js
- Python
- PHP
- Other compatible web applications

Developers can implement automatic tracking, custom events, user identification, and exception reporting through the available tracker functions and integrations.

## MCP and AI Integrations

Umami provides an official read-only Model Context Protocol (MCP) server.

MCP allows compatible AI assistants to retrieve analytics information through a standardized interface.

Supported AI integrations can be used to:

- Query website traffic.
- Compare analytics between reporting periods.
- Analyze visitor trends.
- Review conversion performance.
- Investigate popular pages.
- Examine event statistics.
- Summarize analytical reports.
- Answer questions about website performance.

The official MCP integration is read-only, meaning it can retrieve and analyze available information without modifying analytics data or application settings.

This is useful for teams that want to interact with website analytics using natural-language questions.

## Privacy and Data Protection

Privacy is one of Umami's main design principles.

Unlike conventional tracking platforms, Umami does not use analytics cookies or cross-site advertising identifiers.

Its tracking system is designed to collect useful website statistics without automatically collecting personal information.

The privacy-focused architecture includes:

- No traditional analytics cookies.
- No cross-site tracking.
- No advertising-based visitor profiling.
- Anonymous session identification.
- Configurable tracking behavior.
- Self-hosted data storage.
- Control over analytics retention.
- Privacy controls for supported behavioral analysis features.

Umami calculates anonymous visitor identifiers using information such as the website identifier, visitor IP address, browser user-agent, and a rotating salt.

The IP address is processed during this calculation but is not stored as a separate field in the analytics session record.

This approach helps distinguish anonymous visits while reducing the amount of directly identifiable information stored.

However, privacy-focused analytics does not automatically guarantee GDPR compliance. Compliance depends on how the application is configured, what other tracking technologies are used, and the applicable legal requirements.

Session Replay and additional tracking features should be reviewed separately when configuring privacy policies.

## Security / Administration / Configuration

Umami provides account and website management functionality for controlling access to analytics data.

Because analytics information can reveal business performance, visitor behavior, and internal application usage, deployments should follow appropriate security practices.

Important security practices include:

- Use strong administrator credentials.
- Change the initial administrator password immediately.
- Enable HTTPS for external access.
- Protect application authentication secrets.
- Restrict administrator privileges.
- Assign website access according to team responsibilities.
- Protect API credentials.
- Use secure database authentication.
- Restrict database access to trusted services.
- Configure appropriate data retention policies.
- Protect analytics data through regular backups.
- Review shared dashboard permissions.
- Mask sensitive information in behavioral recordings.
- Keep Umami and its dependencies updated.

Umami supports user accounts, organizations, teams, website permissions, and two-factor authentication.

Two-factor authentication requires the appropriate encryption configuration.

For public analytics services, administrators should carefully review account registration and website sharing policies.

## Best Practices for Umami

- Use a dedicated analytics domain.
- Enable HTTPS for all external access.
- Install the tracking script on every page that requires analytics.
- Use consistent custom event names.
- Track meaningful business actions rather than unnecessary interactions.
- Configure conversion goals for important workflows.
- Use UTM parameters consistently across marketing campaigns.
- Review traffic sources and referral statistics regularly.
- Create separate dashboards for different teams.
- Exclude internal traffic when appropriate.
- Configure privacy settings for session recordings.
- Avoid collecting unnecessary personal information.
- Review visitor retention and conversion trends.
- Protect API credentials and administrative accounts.
- Back up the database regularly.
- Monitor application performance and database growth.
- Keep the application updated.

## Configuration and Administration

After purchasing this application on **Esadax**, you will be able to configure Umami according to your requirements.

The initial setup and administration interface provide access to website management, analytics configuration, user permissions, and tracking preferences.

Important configuration areas include:

### Organization and Account Settings

| Setting                   | Description                                                   |
| ------------------------- | ------------------------------------------------------------- |
| Organization Name         | Name used to identify the analytics organization.             |
| Account Email             | Email associated with the administrator account.              |
| User Permissions          | Access privileges assigned to organization members.           |
| Teams                     | Groups used to organize users and access.                     |
| Authentication            | Account authentication and security preferences.              |
| Two-Factor Authentication | Additional account verification for supported configurations. |

### Website Settings

| Setting                | Description                                                   |
| ---------------------- | ------------------------------------------------------------- |
| Website Name           | Name used to identify the monitored website.                  |
| Website Domain         | Domain associated with the tracking project.                  |
| Website ID             | Unique identifier used by the tracking script.                |
| Tracking Configuration | Controls supported tracking behavior.                         |
| Allowed Origins        | Restricts applicable tracking requests to configured domains. |
| Excluded Events        | Defines events that should not be collected where supported.  |

### Analytics Settings

| Setting             | Description                                            |
| ------------------- | ------------------------------------------------------ |
| Automatic Pageviews | Controls automatic page navigation tracking.           |
| Automatic Events    | Controls supported automatic interaction tracking.     |
| Custom Events       | Defines application-specific events.                   |
| Session Replay      | Configures supported session recording functionality.  |
| Heatmaps            | Manages visual interaction analysis.                   |
| Goals               | Defines important website conversion objectives.       |
| UTM Tracking        | Enables campaign analysis through UTM parameters.      |
| Data Retention      | Determines how long analytics information is retained. |

### Reporting and Sharing

| Setting            | Description                                               |
| ------------------ | --------------------------------------------------------- |
| Default Date Range | Reporting period displayed when opening analytics.        |
| Dashboard Boards   | Organizes selected reports and visualizations.            |
| Shared Links       | Controls access to shared analytics dashboards.           |
| Team Access        | Defines which users can view or manage website analytics. |

Most analytics and website settings can be managed directly through the Umami administration interface.

## Database and Persistent Storage

Umami uses PostgreSQL as its primary database.

The database stores information such as:

- User accounts
- Organizations and teams
- Website configurations
- Pageviews
- Visitor sessions
- Custom events
- Event properties
- Analytics reports
- Campaign information
- Application settings
- Authentication information

The current Umami v3 self-hosted release supports PostgreSQL as its database backend.

The official installation requirements specify PostgreSQL 12.14 or newer.

For reliable operation:

- Use persistent PostgreSQL storage.
- Configure appropriate database permissions.
- Use UTC for consistent timestamp handling.
- Back up the database regularly.
- Protect database credentials.
- Monitor database growth.
- Review analytics retention policies.
- Test database restoration procedures.

Self-hosted analytics data is retained indefinitely unless administrators manually delete it or configure appropriate data management procedures.

Database backups should be included in the regular infrastructure backup strategy.

## Performance and Resource Requirements

Umami is designed to provide lightweight analytics collection and reporting.

Its resource requirements are generally modest compared with larger product analytics platforms, particularly for websites with moderate traffic.

The main resource requirements depend on:

- Number of monitored websites
- Daily visitor volume
- Number of recorded pageviews
- Custom event volume
- Session replay usage
- Data retention period
- Reporting frequency
- Database size

The current self-hosted source installation requires:

| Component  | Requirement                               |
| ---------- | ----------------------------------------- |
| Node.js    | 20.19 or newer                            |
| PostgreSQL | 12.14 or newer                            |
| Memory     | Depends on traffic and database workload  |
| Storage    | Depends on analytics volume and retention |
| Network    | HTTPS access for external tracking        |

PostgreSQL should be monitored as analytics data grows.

For larger installations, database resource allocation and appropriate retention policies become increasingly important.

## Deployment and Maintenance

Umami can be operated as a self-hosted application on infrastructure managed by the organization.

Administrators are responsible for maintaining the application, database, authentication settings, and public tracking endpoint.

Important maintenance activities include:

- Reviewing application updates.
- Applying database schema migrations.
- Monitoring analytics collection.
- Reviewing failed tracking requests.
- Monitoring database performance.
- Managing data retention.
- Backing up analytics information.
- Testing recovery procedures.
- Protecting application secrets.
- Reviewing user access.

The application should be kept updated to benefit from security fixes, performance improvements, and new analytics capabilities.

## Open Source and Licensing

Umami is distributed under the MIT license.

The license permits individuals and organizations to use, modify, and distribute the software according to its terms.

The self-hosted edition allows organizations to operate their own analytics infrastructure without depending on an externally managed analytics account.

This is particularly useful for businesses that prefer maintaining control over website statistics and collected behavioral information.

## Conclusion

Umami is a lightweight, open-source, privacy-focused web and product analytics platform designed to provide meaningful insights without relying on traditional tracking cookies or invasive visitor profiling.

With website analytics, custom events, conversion funnels, retention analysis, UTM tracking, session replay, heatmaps, and revenue reporting, it provides a comprehensive environment for understanding website and application performance.

Its simple tracking integration, centralized dashboards, API access, and self-hosted architecture make it suitable for developers, businesses, SaaS companies, and organizations that want greater control over their analytics data.

Umami is a practical alternative to traditional analytics platforms for anyone looking for straightforward website statistics combined with modern product analytics capabilities.

## Official Resources

- [Umami Official Website](https://umami.is/?ref=blog.esadax.com)
- [Documentation](https://docs.umami.is/?ref=blog.esadax.com)
- [GitHub Repository](https://github.com/umami-software/umami?ref=blog.esadax.com)
- [Installation Guide](https://docs.umami.is/docs/install?ref=blog.esadax.com)
- [Configuration Reference](https://docs.umami.is/docs/environment-variables?ref=blog.esadax.com)
- [Website Analytics](https://docs.umami.is/docs?ref=blog.esadax.com)
- [Custom Event Tracking](https://docs.umami.is/docs/track-events?ref=blog.esadax.com)
- [Conversion Funnels](https://docs.umami.is/docs/funnel?ref=blog.esadax.com)
- [Retention Analysis](https://docs.umami.is/docs/retention?ref=blog.esadax.com)
- [Session Replay](https://docs.umami.is/docs/replays?ref=blog.esadax.com)
- [Heatmaps](https://docs.umami.is/docs/heatmaps?ref=blog.esadax.com)
- [API Documentation](https://docs.umami.is/docs/api?ref=blog.esadax.com)
- [MCP Integration](https://docs.umami.is/docs/mcp?ref=blog.esadax.com)
- [Privacy FAQ](https://docs.umami.is/docs/faq?ref=blog.esadax.com)
- [MIT License](https://github.com/umami-software/umami/blob/master/LICENSE?ref=blog.esadax.com)