# Matomo Analytics
**URL:** https://meta.discourse.org/t/matomo-analytics/33090
**Category:** Theme component
**Tags:** official, matomo-analytics
**Created:** [September 10, 2015, 10:18am UTC](https://meta.discourse.org/t/matomo-analytics/33090 "2015-09-10T10:18:13Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [September 10, 2015, 10:18am UTC](https://meta.discourse.org/t/matomo-analytics/33090/1 "2015-09-10T10:18:13Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Matomo Analytics** is a script to enable Matomo analytics on Discourse. |
| :hammer_and_wrench: | **Repository Link** | [https://github.com/discourse/discourse-matomo-analytics](https://github.com/discourse/discourse-matomo-analytics) |
| :open_book: | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |
Install this theme component
> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started. :+1:
>
> [:question: **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=matomo-analytics "Ask for support on configuring and using Matomo Analytics") [:bug: **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=matomo-analytics "A bug report means something is broken, preventing normal/typical use of the theme component") [:eyes: **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=matomo-analytics "Discussion about the user interface of Matomo Analytics, and how features are presented (including language and UI elements)") [:bulb: **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=matomo-analytics "Discussion about how existing Matomo Analytics features can be improved or enhanced, and how proposed new features could work")
### Features
[Matomo](https://matomo.org/) is an open source analytics platform. Users can choose between self-hosting or paying for professional hosting in the cloud.
> :mega: Matomo was formerly named Piwik. See [Piwik is now Matomo - Announcement - Analytics Platform - Matomo](https://matomo.org/blog/2018/01/piwik-is-now-matomo/) for details about the name change.
To enable Matomo analytics on your Discourse forum, all you have to do is install the official theme component.
**Valid for Matomo API v1.5 and newer**
1. Follow the [theme installation guide](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) to import from the following URL:
2. Enter the `Host URL` and `Website ID`
3. Add the theme component “Matomo Analytics” to your active theme(s).
That’s it!
### Settings
| Name | Description |
| --- | --- |
| host url | Host URL without http:// or https:// |
| website id | |
| exclude groups | Comma separated list of groups to exclude from tracking such as admins, staff |
| user id tracking | An indentifying field name on the current user object such as id, username or external\_id. |
| subdomain tracking | Track visitors across main domain & subdomains, assuming discourse is on a subdomain. |
| do not track | So tracking requests will not be sent if visitors do not wish to be tracked. |
| disable cookies | Disables all first party cookies. Existing Matomo cookies for this website will be deleted on the next pageview. |
### Credits
Thanks to @mattab & @brahn @tagtomat and @simon
> :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans.
> Last edited by @david 2025-01-09T09:44:19Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@chrisblech](https://meta.discourse.org/u/chrisblech)
#### Post date: [October 31, 2016, 2:04pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/22 "2016-10-31T14:04:14Z")
Thanks for this howto, works fine for me. :thumbsup:
In order to comply with the European laws, users must have the possibility to reject piwik’s cookie. Piwik offers a really simple solution for this, by [including an IFrame](https://piwik.org/docs/privacy/#step-3-include-a-web-analytics-opt-out-feature-on-your-site-using-an-iframe).
Unfortunately, Discourse doesn’t allow iframe tags in posts… :grimacing:
Does anyone see a way to include this piwik iframe in Discourse TOS ?
Thanks.
---
### Author:  [@xrav3nz](https://meta.discourse.org/u/xrav3nz)
#### Post date: [October 23, 2018, 3:09pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/30 "2018-10-23T15:09:24Z")
:wave: I just created a new “Matomo Analytics” theme component, and updated [the instructions](https://meta.discourse.org/t/how-to-enable-matomo-analytics-on-discourse/33090) on how to set it up.
Could you give it a try? Please also remember to remove the original custom scripts.
---
### Author:  [@some-user](https://meta.discourse.org/u/some-user)
#### Post date: [October 23, 2018, 3:19pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/31 "2018-10-23T15:19:57Z")
Looks good on first sight. No error in javascript console. Requests to piwik.php being in the webserver log again.
Statistics in Matomo are available as well.
---
### Author:  [@sam](https://meta.discourse.org/u/sam)
#### Post date: [October 23, 2018, 10:27pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/32 "2018-10-23T22:27:23Z")
Is this iframe thing still a concern?
---
### Author:  [@chrisblech](https://meta.discourse.org/u/chrisblech)
#### Post date: [October 24, 2018, 10:54pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/33 "2018-10-24T22:54:40Z")
Hey @xrav3nz :clap: your component works great - thanks!
> [@sam](#):
>
> Is this iframe thing still a concern?
Yes it is. Opt-out should be possible, and Matomo provides this via including an iFrame: [see Matomo documentation](https://matomo.org/docs/privacy/#step-3-include-a-web-analytics-opt-out-feature-on-your-site-using-an-iframe)
---
### Author:  [@Patrick\_David](https://meta.discourse.org/u/Patrick_David)
#### Post date: [December 17, 2018, 8:30pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/34 "2018-12-17T20:30:10Z")
This doesn’t appear to be working for me at the moment? I can add the component, and add the correct URL and siteid, but it doesn’t render anything:
I added the comments around the code to find it quicker in the page:
---
### Author:  [@darix](https://meta.discourse.org/u/darix)
#### Post date: [December 17, 2018, 9:27pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/35 "2018-12-17T21:27:04Z")
We are on beta 6+git1 on our instance
---
### Author:  [@xrav3nz](https://meta.discourse.org/u/xrav3nz)
#### Post date: [December 18, 2018, 2:37pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/36 "2018-12-18T14:37:41Z")
Inline JavaScripts in themes and components are automatically extracted to an external “theme JavaScript” file.
Could you try checking the one immediately after your comments?
---
### Author:  [@Patrick\_David](https://meta.discourse.org/u/Patrick_David)
#### Post date: [December 18, 2018, 3:06pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/37 "2018-12-18T15:06:22Z")
~~This is at the main page on [https://discuss.pixls.us](https://discuss.pixls.us):~~
**Edit**
Hold on, I’ve got a new hash on the file on recent refresh, it looks like the code is there. Thank you @xrav3nz!
Looks like it’s working now - not sure what I was doing wrong yesterday - user error.
---
### Author:  [@downey](https://meta.discourse.org/u/downey)
#### Post date: [April 19, 2019, 12:45am UTC](https://meta.discourse.org/t/matomo-analytics/33090/38 "2019-04-19T00:45:09Z")
So I have the JS loaded into the theme customizations, and the external “theme JavaScript file”`*` is linked in my test browser, just under where I inserted it like in the screenshot in a few posts earlier … BUT the requests aren’t coming through to the Matomo tracking web server.
(Tracking works fine for other non-Discourse sites, FWIW.)
Has anyone else seen that happen?
* * *
`* e.g. https://discourse-cdn.example.com/standard11/theme-javascripts/{numeric_string}.js?__ws=my-discourse-forum.example.org`
---
### Author:  [@surety](https://meta.discourse.org/u/surety)
#### Post date: [September 19, 2019, 3:04am UTC](https://meta.discourse.org/t/matomo-analytics/33090/39 "2019-09-19T03:04:21Z")
Thanks for the component!
I’m confused why the tracking code is sending a custom variable called Anonymous. Isn’t that custom for your particular Matomo setup? It doesn’t seem like it should be there for everyone.
```plaintext
_paq.push(['setCustomVariable', 1, 'Anonymous', !currentUser, 'visit']);
```
I [added a few lines](https://github.com/ryan-boder/discourse-matomo-analytics/commit/25af850e96f361d834427da5ef28f3ec6cb002c7) so that it would track visitors between discourse on a subdomain and a main site. Happy to send a pull request if you want it.
---
### Author:  [@goaround](https://meta.discourse.org/u/goaround)
#### Post date: [November 8, 2019, 8:14am UTC](https://meta.discourse.org/t/matomo-analytics/33090/40 "2019-11-08T08:14:02Z")
You have to whitelist your Matomo-URL inside the Content-Security-Policy-Header. Search for the admin setting content\_security\_policy\_script\_src and add your domain (with https:://) there
---
### Author:  [@danb35](https://meta.discourse.org/u/danb35)
#### Post date: [November 9, 2019, 12:33am UTC](https://meta.discourse.org/t/matomo-analytics/33090/41 "2019-11-09T00:33:50Z")
I’m having trouble making this work on my installation. I’ve installed the component, and added it to my theme, but Matomo is saying there’s no data for the site. I’d think I have the settings correct:
But I’m seeing this error in my browser console:
…and when I look at the site in Matomo, I get this:
What am I missing?
Edit: Further investigation reveals that the error in the Javascript console only appears in Firefox, not in Chrome (with the latest versions of each on a Mac). And I am now seeing some results in Matomo, though Firefox is conspicuously absent–all but one of the visitors are using Chrome; the one exception is using Safari.
---
### Author:  [@danb35](https://meta.discourse.org/u/danb35)
#### Post date: [November 11, 2019, 3:03pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/42 "2019-11-11T15:03:55Z")
Any thoughts on this? This post:
> **[Tracking not working in Firefox](https://forum.matomo.org/t/tracking-not-working-in-firefox/24552)**
>
> I am facing the same problem…I am using 53.0.2. I removed all history, cookies and cache… Didn’t work for me.
suggests that it could be Firefox’s “do not track” settings, but even when I disable them for my site, I’m getting the same error in the web console with Firefox. And Firefox doesn’t seem to be viewing this as a tracker in any event:
---
### Author:  [@goaround](https://meta.discourse.org/u/goaround)
#### Post date: [November 13, 2019, 7:37am UTC](https://meta.discourse.org/t/matomo-analytics/33090/43 "2019-11-13T07:37:41Z")
Try to remove the last / of “[https://www.familybrown.org/analytics/](https://www.familybrown.org/analytics/)” → “[https://www.familybrown.org/analytics](https://www.familybrown.org/analytics)”
---
### Author:  [@danb35](https://meta.discourse.org/u/danb35)
#### Post date: [November 13, 2019, 10:52am UTC](https://meta.discourse.org/t/matomo-analytics/33090/44 "2019-11-13T10:52:09Z")
Thanks. Unfortunately, I’m still getting the same error:
---
### Author:  [@goaround](https://meta.discourse.org/u/goaround)
#### Post date: [November 13, 2019, 2:52pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/45 "2019-11-13T14:52:02Z")
Could you give me the URL of your forum?
---
### Author:  [@danb35](https://meta.discourse.org/u/danb35)
#### Post date: [November 13, 2019, 8:15pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/46 "2019-11-13T20:15:31Z")
> **[SpareOom](https://talk.spare-oom.com/)**
>
> SpareOom is a forum for discussion about, or inspired by, the life and works of C.S. Lewis
---
### Author:  [@eextra](https://meta.discourse.org/u/eextra)
#### Post date: [January 25, 2020, 9:48pm UTC](https://meta.discourse.org/t/matomo-analytics/33090/49 "2020-01-25T21:48:07Z")
Do these two fields need to be completed ? I don’t really understand them.
[Next page](https://meta.discourse.org/t/matomo-analytics/33090.md?page=2)