Go Back

Embedding Piwik PRO reports on websites

January 23, 2018

If you want to boast of the statistics of your website by embedding a single report on it, or if you would like to build your own platform using the Piwik PRO reports. The Widgetize feature is here to help you! Widgetize lets you easily embed Piwik PRO report (or multiple reports) or even a whole Piwik PRO dashboard as an iframe.

Setting the anonymous view access

Since Widgetize is bound to be used without logging into Piwik (by anonymous users) you’ll need to first create a user in your Piwik PRO with only the view rights to the websites that you want to show. It is very important that this user will have only the view rights! – Otherwise, anyone with the access to your website would be able to change things in your Piwik PRO and harm your platform.

Hit the create new user button at the bottom:

Assign him an email and password. Make sure he is set as a user (not owner)

Next click on and the Websites in the top bar:

Locate the website that you want to give access and click the Permissions tab

And set the view access for the newly created user

Your new user has access rights set, now you need to get his API token.

To do that log out of the platform and log in as your new user.

Click your username in the top-right corner of your Piwik PRO Dashboard, and choose “Analytics settings”

Choose API from the left side menu:

Click inside the grey zone to reveal the token_auth. Then copy it.

Getting Widgetize code

With your permissions set and API token saved you can get to the Widgets section:

Now you need to decide what you want to embed and how you want to integrate it with your website.

Embedding the whole dashboard

If you simply want to add your whole Piwik PRO dashboard to your website you can find the iframe code for it here:

Please note that the first code is pointing to the dashboard of the selected website (you can modify this by changing the idSite parameter in the code, or simply choosing the right website with the site selector at the top of the screen.

The second code also has the idSite parameter but you can ignore it as it displays the All Websites dashboard. – Please note that All Websites dashboard will only contain those websites that the user has access to.

Please also note that you can modify the default displayed date and period, in the code (yesterday is the default date and week is the default period)

When you set the code as you like, you’ll need to append the &token_auth parameter that you got in the previous step to your it like this:

This will ensure that the iframe will be working even for users not logged-in to your Piwik PRO.

Embedding single report

In case you’d like to use only single report instead of the whole dashboard, you can pick it from the list at the bottom of the Widgets page

As a result, you’ll receive a direct link or iframe to the report.

Be sure to add the API token to the code, as it’s described in the paragraph above, before embedding in on your website

That’s it you can now place your Piwik reports wherever you like!