Title: OSJ Dashboard Stats for Umami
Author: Lars Jansen
Published: <strong>3 June 2026</strong>
Last modified: 3 June 2026

---

Search plugins

![](https://ps.w.org/osj-dashboard-stats-for-umami/assets/banner-772x250.png?rev
=3559176)

![](https://ps.w.org/osj-dashboard-stats-for-umami/assets/icon-128x128.png?rev=3559176)

# OSJ Dashboard Stats for Umami

 By [Lars Jansen](https://profiles.wordpress.org/larsborg/)

[Download](https://downloads.wordpress.org/plugin/osj-dashboard-stats-for-umami.0.8.3.zip)

 * [Details](https://en-gb.wordpress.org/plugins/osj-dashboard-stats-for-umami/#description)
 * [Reviews](https://en-gb.wordpress.org/plugins/osj-dashboard-stats-for-umami/#reviews)
 *  [Installation](https://en-gb.wordpress.org/plugins/osj-dashboard-stats-for-umami/#installation)
 * [Development](https://en-gb.wordpress.org/plugins/osj-dashboard-stats-for-umami/#developers)

 [Support](https://wordpress.org/support/plugin/osj-dashboard-stats-for-umami/)

## Description

OSJ Dashboard Stats for Umami shows Umami analytics inside the WordPress admin dashboard.

It is built for site owners who use Umami but still spend a lot of time inside WordPress.
Instead of opening a separate analytics tab for quick checks, you can see useful
stats in native WordPress dashboard widgets.

Current dashboard panels include:

 * Today
 * Last 7 Days
 * This Month
 * All Time
 * Top Pages
 * Referrers
 * Social Traffic
 * Right Now

Panels lazy-load after the WordPress dashboard appears, and normal stats are cached
to avoid repeated API calls on every admin page refresh. You can refresh individual
panels manually when you want fresher data.

The plugin can also optionally add the Umami tracking script to your public WordPress
pages. This is off by default. If enabled, the script uses the configured tracker
script URL and Website ID. The plugin does not add public credits, badges, backlinks,
or visible front-end output.

This plugin works with Umami Cloud API keys and self-hosted Umami API setups.

OSJ Dashboard Stats for Umami is not made by, endorsed by, or affiliated with Umami.
It is an independent WordPress integration for sites that use Umami analytics.

### External services

This plugin connects to the Umami API endpoint configured by the site administrator.

The plugin does not contact Umami until an administrator saves connection details
in the plugin settings. When configured, it sends the saved authentication details
and website ID to that Umami API endpoint so it can read analytics data for the 
configured website.

For Umami Cloud, the default API endpoint is:

https://api.umami.is/v1

For self-hosted Umami, the endpoint is whichever API URL the administrator enters
in the plugin settings.

If the optional front-end tracking setting is enabled, the plugin adds the configured
Umami tracker script URL to public WordPress pages with a `data-website-id` attribute.
For Umami Cloud, the common tracker script URL is:

https://cloud.umami.is/script.js

For self-hosted Umami, the tracker script URL is whichever script URL the administrator
enters in the plugin settings.

Umami Cloud is provided by Umami Software, Inc. Self-hosted Umami services are operated
by the owner of the configured Umami instance.

Umami service information:

 * Umami website: https://umami.is/
 * Umami privacy policy: https://umami.is/privacy
 * Umami terms: https://umami.is/terms

The plugin does not send visitor analytics data to Old Stack Journal.

### Privacy

This plugin stores its settings in your WordPress database, including the Umami 
API connection details entered by an administrator.

The plugin uses those details to request analytics data from the configured Umami
API endpoint. If front-end tracking is enabled, the plugin adds the configured Umami
tracker script to public pages so visitor analytics data can be sent to the configured
Umami service.

Front-end tracking is optional and off by default. The plugin does not send analytics
data to Old Stack Journal and does not add visible front-end links or credits.

Site owners are responsible for making sure their use of Umami fits their own privacy
policy, consent setup, and local legal requirements.

## Screenshots

[⌊Cached Umami analytics panels shown directly inside the WordPress dashboard.⌉⌊
Cached Umami analytics panels shown directly inside the WordPress dashboard.⌉[

Cached Umami analytics panels shown directly inside the WordPress dashboard.

[⌊Monthly traffic chart with compact day labels and summary cards.⌉⌊Monthly traffic
chart with compact day labels and summary cards.⌉[

Monthly traffic chart with compact day labels and summary cards.

[⌊Social traffic and referrer panels help show where visits are coming from.⌉⌊Social
traffic and referrer panels help show where visits are coming from.⌉[

Social traffic and referrer panels help show where visits are coming from.

[⌊Settings for connecting Umami Cloud or a self-hosted Umami instance.⌉⌊Settings
for connecting Umami Cloud or a self-hosted Umami instance.⌉[

Settings for connecting Umami Cloud or a self-hosted Umami instance.

[⌊Optional front-end tracking settings, off by default and controlled by the site
owner.⌉⌊Optional front-end tracking settings, off by default and controlled by the
site owner.⌉[

Optional front-end tracking settings, off by default and controlled by the site 
owner.

## Installation

 1. Upload the plugin folder to `/wp-content/plugins/`, or install the plugin ZIP through
    the WordPress Plugins screen.
 2. Activate **OSJ Dashboard Stats for Umami**.
 3. Go to **Settings  OSJ Dashboard Stats**.
 4. Enter your Umami API base URL, auth method, API key or token details, website ID,
    timezone, cache window, and enabled panels.
 5. Use **Save and test connection** to confirm the API can be reached.
 6. Optionally enable the front-end tracking script if you want the plugin to add Umami
    tracking to your public pages.
 7. Visit the main WordPress dashboard.

## FAQ

### Does this add Umami tracking to my site?

Only if you enable it. Front-end tracking is off by default. When enabled, the plugin
adds the configured Umami tracker script to public pages using the configured Website
ID.

### Can I use it only as a dashboard viewer?

Yes. Leave front-end tracking disabled and the plugin will only read stats from 
the configured Umami API endpoint.

### Does this send data to Old Stack Journal?

No. The plugin does not send analytics data to Old Stack Journal.

### Does this work with Umami Cloud?

Yes. Use `https://api.umami.is/v1` as the API base URL and choose the API key auth
method. If you enable front-end tracking, use `https://cloud.umami.is/script.js`
as the tracker script URL.

### Does this work with self-hosted Umami?

Yes. Use your self-hosted Umami API URL and choose bearer token or username/password
login depending on your setup. If you enable front-end tracking, use your self-hosted
tracker script URL.

### Can I stop tracking logged-in users?

Yes. The settings include options to avoid tracking logged-in administrators or 
all logged-in users. Logged-in administrators are excluded by default.

### Why do panels still show a spinner if data is cached?

The dashboard widgets lazy-load through WordPress AJAX so wp-admin can render quickly.
Cached panels should return from WordPress without calling Umami again until the
cache window expires, but the spinner may still appear briefly while WordPress returns
the cached panel HTML.

### Can I hide panels I do not use?

Yes. Use the plugin settings to disable panels, or use WordPress dashboard Screen
Options for normal dashboard widget visibility.

### Does this plugin create public links or credits?

No. The plugin does not add public credits, badges, backlinks, or visible front-
end output.

## Reviews

There are no reviews for this plugin.

## Contributors and Developers

“OSJ Dashboard Stats for Umami” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ Lars Jansen ](https://profiles.wordpress.org/larsborg/)

[Translate “OSJ Dashboard Stats for Umami” into your language.](https://translate.wordpress.org/projects/wp-plugins/osj-dashboard-stats-for-umami)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/osj-dashboard-stats-for-umami/),
check out the [SVN repository](https://plugins.svn.wordpress.org/osj-dashboard-stats-for-umami/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/osj-dashboard-stats-for-umami/)
by [RSS](https://plugins.trac.wordpress.org/log/osj-dashboard-stats-for-umami/?limit=100&mode=stop_on_copy&format=rss).

## Change Log

#### 0.8.3

 * Tightened the This Month chart so the full month fits without horizontal scrolling.
 * Changed This Month chart labels to compact day numbers.

#### 0.8.2

 * Padded the This Month chart so the full calendar month is shown, even at the 
   start of the month.

#### 0.8.1

 * Fixed dashboard updated timestamps so they display in the configured WordPress/
   site timezone.
 * Avoided the single-bar monthly chart state when the current month only has one
   data point.
 * Added a languages folder placeholder for the declared text domain path.
 * Reduced Plugin Check warnings around settings sanitization, translator comments,
   and uninstall cleanup.

#### 0.8.0

 * Added optional front-end Umami tracking script insertion.
 * Tracking is off by default and only runs when explicitly enabled in settings.
 * Added configurable tracker script URL, optional separate tracking Website ID,
   head/footer location, and logged-in user exclusions.
 * Added WordPress privacy-policy helper text for sites that enable tracking.
 * Updated readme/privacy wording to reflect optional tracking support.

#### 0.7.0

 * Submission-prep pass.
 * Polished readme wording for a public WordPress.org plugin listing.
 * Removed internal development-stage wording from public documentation.
 * Added clearer install wording for ZIP/plugin-screen installation.
 * Confirmed the plugin does not add public links.

#### 0.6.0

 * Repository-readiness pass.
 * Replaced PHP 8-only `str_contains()` usage so the plugin matches its PHP 7.4 
   requirement.
 * Added stricter API base URL and timezone sanitization.
 * Added enabled-panel checks to the AJAX loader.
 * Improved uninstall cleanup for cached API responses and self-hosted login tokens.
 * Expanded readme privacy and external service disclosures.
 * Removed private-site wording from the not-configured dashboard state.

#### 0.5.1

 * Updated dashboard panel titles to use the `OSJ Umami Stats - ...` naming pattern.

#### 0.5.0

 * Public plugin rename to OSJ Dashboard Stats for Umami.
 * Added public slug/text-domain/class/action naming.
 * Kept the working lazy-loaded cached dashboard panel system from the private OSJ
   build.
 * Added a legacy settings fallback from the private test plugin option name.

## Meta

 *  Version **0.8.3**
 *  Last updated **5 months ago**
 *  Active installations **10+**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.0.7**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/osj-dashboard-stats-for-umami/)
 * Tags
 * [analytics](https://en-gb.wordpress.org/plugins/tags/analytics/)[dashboard](https://en-gb.wordpress.org/plugins/tags/dashboard/)
   [privacy](https://en-gb.wordpress.org/plugins/tags/privacy/)[statistics](https://en-gb.wordpress.org/plugins/tags/statistics/)
   [umami](https://en-gb.wordpress.org/plugins/tags/umami/)
 *  [Advanced View](https://en-gb.wordpress.org/plugins/osj-dashboard-stats-for-umami/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/osj-dashboard-stats-for-umami/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/osj-dashboard-stats-for-umami/reviews/)

## Contributors

 *   [ Lars Jansen ](https://profiles.wordpress.org/larsborg/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/osj-dashboard-stats-for-umami/)