A simple way of giving other people access to your Matomo (Piwik) analytics is to send regular emails reports specifically tailored to their needs. You can send reports as a PDF file or as HTML content or as attached CSV file.
In the Matomo top bar, click on “Administration”, then in the left menu below “Personal” click the link “Email reports” to view the list of scheduled email reports. Here it is, with two reports that have already been created for this website:
Create and schedule a report
Click ‘Create and Schedule a report’. The form for adding new reports is simple. The first five questions ask for details about where and how the report should be sent. You can select the email report format: HTML, PDF or CSV. You choose what visits are included in the report. By default “Choose a segment” is empty and the email report includes “All Visits”. Alternatively you can select any of your existing Custom Segment and the scheduled report will only include data for the users matching your segment. We’re sending this email report to both firstname.lastname@example.org and email@example.com:
Under “Display options” is the option to choose whether the scheduled email report should display:
- report tables for all reports and graphs only for key metrics (default)
- graphs only (no report tables)
- display report tables and graphs for all reports
- display report tables only (no graphs)
- when you choose to include graphs in all reports, then you can select “Show Historical Graphs for the top 5 values” to get a historical graph displayed for each report.
- when evolution graphs are displayed within the report you can also choose whether the graphs show each day within the report’s selected period, or whether to show the evolution over the last periods (for example, the last N weeks for a weekly email report or the last N months for a monthly email report).
The final section lets you select which metrics and reports the email report should include. You can choose any of the metrics and reports Matomo has to offer, and of course you can choose more than one:
When you are ready, click the ‘Update Report’ button at the bottom of the page.
Your new report will be added to the list.
Downloading and sending your custom reports by email
You can click “Download” or “Send now” to check that the email report works as expected, and contains all the reports you and your colleagues need. When you click “Download” or “Send now” the reports will contain information for the date currently selected in the calendar. However, when reports are sent automatically daily/weekly/monthly, the reports will automatically be sent for the previous day/week/month respectively.
By default, some reports (such as “visits overview” and “goals”, for example) will include the evolution graph to give some historical context about website traffic and performance:
Email reports (PDF or HTML or CSV) and graphs will also display in languages using other character sets (assuming you uploaded the unicode font), such as this example of a report generated by a Japanese Matomo user:
If you selected the option to include graphs in the report, here is an example “Top Browsers” page from a PDF email report:
If you selected “Show Historical Graphs for the top 5 values” to get a historical graph displayed above each report, this is how it would look like, here is an example for the Acquisition Channel Type report:
Sending Scheduled reports on Time
To make sure your daily/weekly/monthly analytics reports are as early as possible after a day or a week or a month is finished, please setup the automatic archiving cron. This script will ensure that all your report data is processed on time and that your scheduled email and SMS reports will be sent when they are due.
Note that if you do not setup this script as we recommend, Matomo will still work and send your scheduled reports. This works as follows: a visitor viewing one of the websites tracked in Matomo will actually trigger the processing of data and sending the email reports. For better reliability though, we highly recommend to setup the automatic archiving cron. This will ensure your reports will be delivered on time and every time.
Unsubscribing from reports
At the bottom of each email report, recipients will find a link to “Unsubscribe” from the reports. When they click the link they will be asked to confirm they want to unsubscribe from this email report.
Send your key metrics as SMS text message
Your key metrics about your website and app can also be sent by SMS text message to one or several phone numbers. To enable SMS text messages, go to Matomo > Settings > Mobile Messaging.
The following SMS providers are currently available:
There may be more SMS Providers available on the Matomo Marketplace.
Learn more in our Email & SMS video.
White Label your analytics emails
You can change the header bar color, font color, and hide the Matomo Analytics branding in the footer of email reports by using the White Label plugin.