Matomo 5.5.0
9 October 2025
Matomo version 5.5.0 is now available (major release).
Upgrading to Matomo 5.5.0
Matomo 5.5.0 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.5.0 upgrade prior to applying it live. Get started managing your Matomo installations with Installatron
What's New in Matomo 5.5.0
Highlight: AI Assistants Channel Type
- Matomo has introduced a dedicated AI Assistants channel type, grouping visits from tools such as ChatGPT, Copilot, Gemini, Claude, Perplexity, and more.
- This new channel makes AI-driven traffic clearly identifiable, enabling you to analyse its impact, build targeted segments, and track the growing role of AI referrals in your overall traffic mix.
- The AI Assistants channel type is integrated into your Acquisition reports, giving you a clear breakdown of visits from AI referrals to compare against other channels.
Core improvements
- #23564, #19306: Migrate annotations to a dedicated database table. [by @michalkleiner, @sgiehl]
- #22024, #23396: Fix incorrect archive recreation for periods without visits. [by @sgiehl, @nathangavin, @mneudert]
- #23530: Hide ‘Install all plugins’ button when Marketplace is disabled. [by @sgiehl]
- #23605: Add setReferralUrlMaxLength() to the JS Tracker to allow limiting the referral cookie size. [by @MichaelRoosz, @sgiehl]
- #23573, #23611: Fix the Themes admin page to show available updates (like the Manage Plugins page). [by @sgiehl]
New features and enhancements
- #22831, #23457: Introduced the new AI Assistants acquisition channel type to categorise and analyse traffic originating from AI platforms such as ChatGPT, Le Chat, Perplexity and more. [by @sgiehl]
- #23449, #23450: Reordered sections in the Dashboard selector to first display the Manage Dashboard and Create new Dashboard options. [by @michalkleiner]
- #23571: A new config_id randomisation setting is now available available as an optional privacy control that must be explicitly enabled by the user. Learn more about how to enable the randomise config_id setting. [by @michalkleiner]
- #20826, #23520: When a user invites another person to join Matomo, the invite acceptance notification is now in the inviter’s language to ensure the confirmation is localised consistently. [by @michalkleiner]
Security
- #23575: Disabled the Superuser checkbox in Users > Permissions when a superuser edits their own account. This prevents accidental self-revocation of all access. [by @snake14, @sgiehl]
- #23582, #23622: Refactor the token notification system to consolidate messages and send a single email per user that includes details for all their tokens. [by @michalkleiner, @caddoo]
Reporting
- #23578: Correctly escape line breaks in CSV and TSV exports so that files can be reliably imported into tools like Excel. [by @sgiehl]
- #23535: Rename the Email Reports menu and table title to Schedule Reports. [by @AltamashShaikh, @sgiehl]
- #23569: Make segment help texts translatable. [by @sgiehl, @michalkleiner]
- #23581: Translations in token emails are currently HTML-escaped, causing encoded entities to appear instead of the correct characters. This issue removes the escaping so the text renders properly. [by @sgiehl, @nathangavin, @michalkleiner]