Changelog
5.1.10 - 2026-09-14 - Fixed the metric selector overlapping the Cohorts widgets' own controls, which left refresh, minimise, maximise and close unusable on a dashboard and blocked the close button of a maximised widget. It now sits in its own row above the report, at the same width in both widgets, and the Cohorts Chart's last horizontal axis label is no longer cut off at the edge of the widget. - Fixed the Cohorts Chart not showing percentage metrics such as Returning Visitors % when Matomo was used in Basque, Kurdish or Turkish, and rounding them down to whole percents in Persian. Its vertical axis and tooltips now show the percent sign. - Fixed two Cohorts widget display issues: a long metric name was drawn over the metric selector's dropdown arrow, and the chart legend did not line up when it wrapped onto a second line. - Fixed the Cohorts Chart widget plotting the oldest cohorts, which are usually empty, until another metric was picked. It now shows the same most recent cohorts on a dashboard whatever number of cohorts the Cohorts page is set to. - Fixed the Cohorts Chart widget's vertical axis labels being drawn against the edge of the widget instead of clear of it, as they are on Matomo's other charts.
5.1.9 - 2026-08-10 - Disabled the metric forecast on the Cohorts evolution graphs (introduced in Matomo 5.13), as forecasts are not meaningful for cohort data
5.1.8 - 2026-04-27 - Renamed "Cohorts" to "Cohorts Table" in "Add dashboard widget" UI - Updated API documentation
5.1.7 - 2026-02-02 - Updated API documentation
5.1.6 - 2025-11-24 - Improved url parameter checking for Get Cohorts report
5.1.5 - 2025-09-01 - Added dashboard widget for the updated Cohorts Chart
5.1.4 - 2025-07-07 - Textual change
5.1.3 - 2025-04-14 - Adjusted Cohorts Chart to stop cohort lines when no more data exists for that cohort
5.1.2 - 2025-03-31 - Changed the position of metrics filter - Improved text for number of cohorts dropdown - Corrected issue preventing closing the Cohorts widget
5.1.1 - 2025-01-28 - Changed period default to empty from null, to not throw an exception if undefined - Updated cover images to show new visualisation change
5.1.0 - 2025-01-20 - Cohort visualisation graph updated to show growth/drop-off per cohort - Fixed a PHP error due to a wrong datatype
5.0.11 - 2024-11-05 - Updated README.md
5.0.10 - 2024-08-26 - Pricing updated
5.0.9 - Added cover image for marketplace
5.0.8 - Started hiding icon to change visualisation - Fixed background color of gradient to start from #3450A3
5.0.7 - Improving the algorithm that converts time strings back to numeric values for comparison
5.0.6 - Fixed hover for first columns to show required info
5.0.5 - Updated README.md - Adjustments to the color gradient logic
5.0.4 - Archiving: Ensure parameter is provided in correct type
5.0.3 - Minor UI fixes
5.0.2 - Fix issue with evolution graph not always loading correctly
5.0.1 - Compatibility with Matomo 5.0.0-b4
5.0.0 - Compatibility with Matomo 5
4.0.8 - Fix issue with Matomo 4.14
4.0.7 - Added semantics type for metrics - Widening narrow select
4.0.6 - Added translation using Weblate (Bulgarian)
4.0.5 - Fixes to handle notices
4.0.4 - Fixed userID not getting archived for non day report - Fixed encoding issue for graph labels
4.0.3 - Add category help text
4.0.2 - Fix archiving error
4.0.1 - Rearchive reports on activation
4.0.0 - Compatibility with Matomo 4
3.0.11 - Fix SQL error when fetching one day as a range
3.0.10 - Add segment even if no idSite is specified, but idSites (witth the ending "s") is specified so API.getSegmentsMetadata will show the segment.
3.0.9 - Fix archiving issue where archiving ranges caused broken SQL. (Archiving ranges for Cohorts should only trigger day archiving, nothing else.)
3.0.8 - Add code to disable comparison in anticipation of 3.12. - Fix for showing nb_users along w/ nb_uniq_visitors when enabled. - Changes to README.
3.0.7 - Move Cohorts menu item to Visitors menu. - Fix bug in naming of ecommerce goal metrics.
3.0.6 - Fix bug if no data in evolution graph, no rows are selectable. - Fix bug that doubled selectable rows each time a new row was selected in evolution graph. - Fix bug in detection of date for cohort tooltip.
3.0.5 - Fix warning when computing cell background and cell tooltip.
3.0.4 - Fix unique visitors calculation for year periods.
3.0.3 - Disable report metadata since scheduled reports/mobile app cannot handle cohort reports yet.
3.0.2 - Bug fix affecting controller actions that do not require an idSite parameter. - Bug fix affecting cohorts INI config if already present when installing plugin.
3.0.1 - Bug fix for cohort table translations. - Bug fix for viewing cohorts w/ range periods.
3.0.0 - Initial public release