Matomo 5.6.1
28 November 2025
Matomo version 5.6.1 is now available (major release).
Upgrading to Matomo 5.6.1
Matomo 5.6.1 can be upgraded to (or installed) using any of Installatron's products. Use Installatron's optional Automatic Update feature to automatically apply Matomo updates as new versions are released, or use Installatron's Clone feature to duplicate an existing Matomo install to test the 5.6.1 upgrade prior to applying it live. Get started managing your Matomo installations with Installatron
What's New in Matomo 5.6.1
5.6.1
Bug Fixes
- #23837 Fix possible archiving error “Column “referer_type” in WHERE is ambiguous – in plugin Referrers” [by @sgiehl]
- #23827, #23824 Fix external themes that are using CSS custom props [by @tzi]
5.6.0
Core improvements
- #23443: Extend the anonymisation settings to be site specific. [by @michalkleiner]
- #22998, #23719: Fix warning on incompatible plugins when updating Matomo to version 5.2.2. [by @michalkleiner, @sgiehl]
- #23688, #23711: Fix error after updating from Matomo 5.3.2:Entry “Piwik\Plugins\FeatureFlags\FeatureFlagManager” cannot be resolved. [by @sgiehl, @michalkleiner]
UI/UX improvements
- #23557, #23685, #1052, #215, #1053: Corrected an issue that prevented new users from completing the 2FA step. [by @sgiehl, @tzi, @michalkleiner]
- #23693: Update the modal system to be responsive and centred with intuitive scrolling. [by @tzi, @michalkleiner]
- #23713: Update the navbar help icon. [by @tzi, @sgiehl]
- #23733, #10562: Fix margins of controls for insight data table in widgets. [by @tzi, @sgiehl]
- #23687: Fix QuickAccess input tooltip styles. [by @tzi, @sgiehl]
- #23741: Fix Ajax loader design and spacing. [by @tzi, @michalkleiner]
- #23742: Improve layout for Matomo loader elements. [by @tzi, @michalkleiner]
- #23756: Improve keyboard navigation in navbar, sidenav and top controls. [by @tzi, @michalkleiner]
Compatibility
- #23655: Ensure compatibility with PHP 8.5. [by @sgiehl, @michalkleiner]
- #23776: Replace Global minimum_mysql_version with adapter-specific checks. [by @chippison, @caddoo, @sgiehl]
Reporting
- #23615, #23677: In AI Assistants show the entry page URL / title as a subtable. [by @sgiehl, @mneudert]
- #23617: Capture new metrics for AI Agent requests. [by @mneudert, @sgiehl]
- #23717, #23731: Small layout improvements on Segment editor dropdown. [by @tzi, @sgiehl, @michalkleiner]
- #23786, #20695: Remove the Row Evolution on the Behaviour > Performance Reports. [by @chippison, @sgiehl]
- #23791: When creating a new custom dimension, the Active checkbox is enabled by default. [by @chippison, @sgiehl]
- #23794: Simplify the Visitor Profile popup URL parameter. [by @sgiehl, @michalkleiner]