Umami Analytics
Analytics
Display visitor stats from your Umami analytics instance
The Umami Analytics widget displays key visitor metrics from a website tracked by your Umami instance — pageviews, unique visitors, visits, bounce rate, avg. visit duration, and real-time active visitor count. The widget body can be switched between a visitor/event chart, a multi-event chart, and ranked top pages or referrers lists.
Supported Integrations​
UmamiPrivacy-focused, open-source web analytics
Adding the widget​
You can find how to add the widget on the Widgets documentation page.
Configuration​
| Name | Description | Values | Default value |
|---|---|---|---|
| Website | Select a website tracked by your Umami instance. Populated automatically from the connected integration. | Website selector | None |
| Time frame | The time period to display visitor data for |
| Last 24 hours |
| View | What to display in the widget body. Visible once a website is selected. |
| Chart |
| Chart type | Display style for the chart. Visible when View is "Chart" or "Events chart". |
| Bar chart |
| Chart style | How to render the event series alongside visitors. Visible when View is "Chart", Chart type is "Bar chart", and an Event is selected. |
| Side by side |
| Event | Overlay a single named event on the visitor chart. Populated from event names recorded by Umami. Visible when View is "Chart". | Event name selector | None |
| Events | Select one or more events to plot as individual series with no visitors baseline. Populated from event names recorded by Umami. Visible when View is "Events chart". | Multi-select event name selector | None |
| Items to show | Number of top items to display. Visible when View is "Top pages" or "Top referrers". | Number (1–500) | 5 |
View modes​
| View | Description |
|---|---|
| Chart | Bar chart or sparkline of unique visitors over the selected time frame. Optionally overlay a single named event as a second series. |
| Events chart | Multi-select one or more named events and chart each as its own colored series — no visitor baseline. Supports bar and sparkline. |
| Top pages | Ranked list of URLs by pageview count for the selected time frame. |
| Top referrers | Ranked list of referrer sources by session count. Direct traffic (no referrer) is labeled "Direct". |
Notes​
- The Website selector is populated automatically from the websites tracked by the connected Umami integration. No manual ID entry is required.
- Event names for the Event and Events selectors are fetched from Umami's metrics API based on the past 30 days of activity.
- Active visitor count refreshes every 30 seconds independently of the main data cache.
- All other data is cached for 5 minutes and refreshed in the background by a cron job.