Koko Analytics


Koko Analytics is a privacy-friendly analytics plugin for WordPress. It does not use any external services, so data about your visitors is never shared with any third-party company.

Furthermore, no visitor specific data is collected and visitors can easily opt-out of tracking by enabling «Do Not Track» in their browser settings.

Stop sharing visitor data with third-party companies making money off that same data. Stop unnecessarily slowing down your website. Koko Analytics lets you focus on what is important and gives you all the essential metrics, while respecting the privacy of your visitors.


  • Plug and play: After installing and activating the plugin, stats will automatically be collected.
  • Privacy: No personal information or anything visitor specific is tracked.
  • GDPR: Compliant by design.
  • Data ownership: No external services are used. Data about visits to your website is yours and yours alone.
  • Performance. Handles sudden bursts of traffic without breaking a sweat.
  • Metrics: All the essentials: visitors, pageviews and referrers.
  • Cookies: There is an option to not use any cookies.
  • Referrer spam: Built-in blacklist to filter out referrer spam.
  • Cache: Fully compatible with pages served from any cache.
  • AMP: Tracks AMP powered pages too.
  • Open-source: Code is released under the GPL 3.0 license.


You can contribute to Koko Analytics in many different ways. For example:


  • Koko Analytics' dashboard to view your website statistics.
  • The settings page where you can exclude certain user roles from being counted.
  • A widget to show your most viewed posts (or any other post type) for a given period.
  • The dashboard widget to quickly show your site visits over the last 2 weeks.


  1. In your WordPress admin area, go to Plugins > New Plugin, search for Koko Analytics and click Install now.
  2. Alternatively, download the plugin files and upload the contents of koko-analytics.zip to your plugins directory, which usually is /wp-content/plugins/.
  3. Activate the plugin. Koko Analytics will start recording stats right away.
  4. Access your analytics by browsing to Dashboard > Analytics in your WordPress admin area.

Часто задаваемые вопросы

Does this respect my visitor’s privacy?

Absolutely, nothing that could lead back to the visitor is recorded. If the visitor has «Do Not Track» enabled in their browser settings, the visitor won’t be tracked at all.

Does this use any external services?

No, the data never leaves your website. That’s (part of) what makes Koko Analytics such a great choice if you value true privacy.

Does this set any cookies?

By default, yes. But you can easily disable this in the plugin’s settings. Without cookies the plugin can still detect unique pageviews, but not returning visitors.

Will this slow down my website?

No, the plugin is built in such a way that it never slows down your website for your visitors. If there is any heavy lifting to be done, it is done in a background process.

In fact, because the plugin does not depend on any external services it is usually much faster than third-party analytics tools.

No pageviews are being recorded.

This is usually a file permissions issue. The first thing to check is whether the /wp-content/uploads/pageviews.php file exists and is writable by your web server.

How to only use cookies after consent?

First configure Koko Analytics to not use any cookies by default.

Then configure your cookie consent plugin to add the following code for visitors that have given consent:

window.koko_analytics.use_cookie = true;


In my enthusiasm I published my tutorial blog, and suddenly - while only having my smartphone available as I was outdoors - I remembered I wanted to install Koko before I started blasting out the news. Danggg, the news was out. I logged in, installed Koko, and immediately stats were up and running! Holy macaroni, smoothest analytics plugin install ever!
I am impressed with the simple interface and being lightweight of this plugin. I also did not observe any heavy load on my host CPU, perhaps its because it doesn't rely on external sources. A well coded plugin. Kudos to the dev. Cheers.
I had been using Statcounter (a paid service) for many years. I tried various different WordPress plugins to replace it, but nothing worked that well or reported consistent traffic numbers. Finally, I saw a recommendation for new Koko Analytics in the Kinsta newsletter. This WP plugin is free, super-easy to set up, and works perfectly out of the box. It tracks the same data that Statcounter reports, with virtually identical results. Thanks! You just made my website faster to load and less expensive to operate. Plus (finally!) no more data going to a third party – which likely also helps my site's SEO and traffic.
Got it running on my Blog for nearly two weeks now. No Problems at all, fast tracker without overloaded functions.
The best plugin to view website analytics quickly and easily.
Посмотреть все 29 отзывов

Участники и разработчики

«Koko Analytics» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:


«Koko Analytics» переведён на 8 языков. Благодарим переводчиков за их работу.

Перевести «Koko Analytics» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.0.10 — Mar 23, 2020

  • Print configuration object early on in page HTML so it is easier to override it using a cookie consent plugin.
  • Add help text explaining the use of a multi-select element.

1.0.9 — Mar 9, 2020

  • Use arrow keys (without Ctrl-key) for quickly cycling through date ranges.
  • Group chart by month if showing more than 2 (full) months of data.
  • Replace React by Preact to cut JS bundle size in half.
  • Normalize referrer URL’s without protocol.
  • Improve total comparision with previous period.

1.0.8 — Feb 14, 2020

  • Add date preset for last 28 days
  • Add keyboard navigation support for quickly cycling through date periods (Ctrl + Arrow key)
  • Expand referrer aggregation logic. If you have any URL’s you would like to see combined into a single domain, please post them here.
  • Fix referrer URL’s table missing the AUTO_INCREMENT statement.
  • Change dropdown to number input in most viewed posts widget.
  • Show notice on dashboard page if an issue with WP Cron is detected.
  • Improved y-axes in chart when maximum value is lower than 10.
  • Use colors from admin scheme in chart tooltip.

1.0.7 — Jan 30, 2020

  • Aggregate certain referrers, e.g. google.com/search becomes google.com.
  • Use WordPress color scheme (from user profile) for colors in chart.
  • Show more labels on the chart’s x-axes (wide screens only).
  • Show number of pageviews in the last hour.
  • Show day of week to chart tooltip.
  • Use Paul Heckbert’s loose labels (nice numbers) algorithm for labels on y-axes.
  • All colors now have a contrast ratio that is (at least) WCAAG AA compliant.
  • Revert multiple bar chart change (because of user feedback), use inner bar instead.
  • Minor performance optimisations for viewing dashboard page.
  • Fixes «Invalid time» error when re-opening the dashboard in Safari.

1.0.6 — Jan 20, 2020

  • Remember view period when navigating away from analytics dashboard.
  • Add filter hook to prevent loading the tracking script: koko_analytics_load_tracking_script
  • Ignore all user agents containing the word seo
  • Ignore requests if page is loaded inside an iframe.
  • Only read document.cookie if cookie use is actually enabled.
  • In chart, use separate bars instead of stacked bars.

1.0.5 — Dec 30, 2019

  • Add «today» option to date periods preset menu.
  • Hide chart component when viewing just a single day of data.
  • Automatically refresh data in dashboard every minute.
  • Use human readable number format on chart’s y-axes.
  • Show chart elements even if outside of chart container.

1.0.4 — Dec 13, 2019

  • Fix referrer URL’s not being saved correctly.
  • Fix unique pageview detection
  • Fix pretty number with only trailing zeroes.
  • Fix bar chart not stacking properly.
  • Improved display of Twitter or Android app referrers.
  • Improved chart tooltip.
  • Improved styling for small mobile screens.
  • Trim trailing slashes from referrer URL’s.
  • Escape all strings coming from translation files.
  • Filter out common bots by checking user agent in tracking script.

1.0.3 — Dec 6, 2019

  • Fix link to settings page from plugins overview page.
  • Fix REST API URL’s when not using pretty permalinks.
  • Add support for tracking AMP-powered pages.
  • Add setting to disable cookie usage.
  • Handle network request errors on admin pages.
  • Return HTTP 500 error when unable to write to buffer file.
  • Simplify adding post title to post type statistics.
  • Extend browser support to include older browsers.
  • Handle filesystem errors in aggregation process.

1.0.2 — Nov 22, 2019

  • Add icons to datepickers to quickly cycle through selected date periods.
  • Add capabilities view_koko_analytics and manage_koko_analytics to control whether a user role can view or manage statistics.
  • Add setting to automatically delete data older than X months.
  • Add menu item to WP Admin Bar.
  • Update URL when date range changes so page can be refreshed or shared.
  • Update browser history with chosen date ranges.
  • Show total size of Koko Analytics’ database tables on settings page.
  • Improved animations when dashboard data updates.
  • Improved column type constraints for storing data.
  • Improved labels for chart x-axes.
  • Consistent ordering of posts and referrers tables.
  • Remove trailing ? character from referrer URL’s after query parameters are stripped.
  • Fix retrieving post title when post type is excluded from search.

1.0.1 — Nov 14, 2019

  • Add dashboard widget showing site visits over last 14 days.
  • Add widget for showing most viewed posts, pages or any other post type over a given period.
  • Add [koko_analytics_most_viewed_posts] shortcode.
  • Add pagination to tables showing top posts and top referrers.
  • Add settings link to plugin row on plugins overview page in WP admin.
  • Use ASCII for storing textual data. Fixes an issue with error message «specified key is too long» on some MySQL installations when the charset is utf8mb4.
  • Remove all data when uninstalling the plugin. Thanks to Santiago Degetau.
  • Improved memory usage when handling huge bursts of traffic.
  • Load tracking script asynchronously.
  • Styling improvements for the dashboard page.

1.0.0 — Nov 4, 2019

Initial release.