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. 
Monthly traffic chart with compact day labels and summary cards. 
Social traffic and referrer panels help show where visits are coming from. 
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.
Installation
- Upload the plugin folder to
/wp-content/plugins/, or install the plugin ZIP through the WordPress Plugins screen. - Activate OSJ Dashboard Stats for Umami.
- Go to Settings OSJ Dashboard Stats.
- Enter your Umami API base URL, auth method, API key or token details, website ID, timezone, cache window, and enabled panels.
- Use Save and test connection to confirm the API can be reached.
- Optionally enable the front-end tracking script if you want the plugin to add Umami tracking to your public pages.
- 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/v1as the API base URL and choose the API key auth method. If you enable front-end tracking, usehttps://cloud.umami.is/script.jsas 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 & Developers
“OSJ Dashboard Stats for Umami” is open source software. The following people have contributed to this plugin.
Contributors
Translate “OSJ Dashboard Stats for Umami” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.