ClickyPanelBuy now

Connect Matomo

Add a Matomo site with your instance URL and an API token. Works with Matomo Cloud and self-hosted.

Matomo Cloud and self-hosted Matomo are reached exactly the same way, so there is one setup for both: the address of your Matomo and an API token.

Steps

  1. In Matomo, open Administration → Personal → Security and scroll to Auth tokens.
  2. Choose Create new token, give it a description, and copy it. Matomo shows it once.
  3. In ClickyPanel, choose Add site → Matomo.
  4. Enter your instance URL - the address you log in at, for example https://analytics.example.com or https://yourname.matomo.cloud. No trailing slash.
  5. Paste the token. ClickyPanel lists every site your token can view so you can pick which to add.

What your token needs

View access is enough. ClickyPanel lists sites with SitesManager.getSitesWithAtLeastViewAccess rather than getAllSites, so an ordinary user token works and no superuser access is required.

If you ticked Only allow secure requests when creating the token, that is fine and recommended. ClickyPanel always sends the token in an Authorization header, never in the URL, which also keeps it out of any proxy or server logs along the way.

Numbers to know about

Today and yesterday show unique visitors. The 7-day and 30-day figures show visits. This is a Matomo constraint, not a choice: Matomo computes unique visitors per day and refuses to compute them across a date range, because summing daily uniques would count a returning visitor more than once. So the longer ranges report visits instead, and the two numbers are not the same metric. Matomo’s own documentation covers this in FAQ 113.

Visitors online covers the last 5 minutes. Matomo’s own dashboard uses 30 minutes. We use 5 so that the number sitting next to your other sites’ numbers means the same thing on every card.

Rate limits

Matomo publishes no fixed API rate limit; a self-hosted instance is limited by your own server. Every refresh is a single HTTP request - ClickyPanel batches its sub-requests with API.getBulkRequest, so an overview costs one call, not four.

Known limitation

“Open in Matomo” may not appear for Matomo sites. A Matomo site id like 1 means a different site on every instance, and the deep link is built without access to your stored credentials, so ClickyPanel leaves the link out rather than risk sending you to the wrong server. Being fixed.