Widgets¶
You can add the Matomo widgets like any other widget to a dashboard. Please note, that the widgets have to be enabled in the site configuration and the permissions for editors have to be granted to be able to use these widgets.
Hint
Most widgets need an activated module in Matomo to work. If a module is not available, an error is displayed in the widget. The parameters of the underlying data providers can be adjusted. Have a look into the Widget configuration section.
The following widgets are available:
Tip
Do you miss a widget? Open a feature request and perhaps the widget is available in the next release.
Actions per day¶
This widget displays the number of actions per day for the last 28 days (including the current day). Actions are:
- Page views
- Downloads
- Clicks on outlinks

Widget Actions per day
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.actionsPerDay.parameters
- period: day
- date: last28
Actions per month¶
This widget displays the number of actions per month for the last 12 months (including the current month). Actions are:
- Page views
- Downloads
- Clicks on outlinks

Widget Actions per month
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.actionsPerMonth.parameters
- period: month
- date: last12
Bounce rate¶
The bounce rate for the current month shows this widget:

Widget Bounce rate
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.bounceRate.parameters
- period: month
- date: today
- matomo_widgets.bounceRate.subtitle
- in the current month
Browsers¶
The browser share for the current month shows this widget:

Widget Browsers
- Matomo module
- DevicesDetection
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.browsers.limit
- 5
- matomo_widgets.browsers.parameters
- period: month
- date: today
- filter_sort_column: nb_visits
- filter_sort_order: desc
Campaigns¶
Displays a report of the campaigns for the current month:

Widget Campaigns
- Matomo module
- Referrers
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.campaigns.parameters:
- period: month
- date: today
- filter_limit: 30
- filter_sort_column: nb_visits
- filter_sort_order: desc
Countries¶
Shows a list of countries from which the website was visited in the current month:

Widget Countries
- Matomo module
- UserCountry
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.country.parameters:
- period: month
- date: today
- filter_limit: 50
- filter_sort_column: nb_visits
- filter_sort_order: desc
Link to Matomo¶
A call-to-action widget is used to show a link to the configured Matomo installation:

Widget Link to Matomo
Operating system families¶
The operating system families used by the visitors for the current month:

Widget Operating system families
- Matomo module
- DevicesDetection
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.osFamilies.limit:
- 5
- matomo_widgets.osFamilies.parameters:
- period: month
- date: today
- filter_sort_column: nb_visits
- filter_sort_order: desc
Visits per day¶
This widget displays the number of visits per day for the last 28 days:

Widget Visits per day
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.visitsPerDay.parameters:
- period: day
- Date: last28
Visits per month¶
This widget displays the number of visits per month for the last 12 months:

Widget Visits per month
- Matomo module
- VisitsSummary
- Default configuration parameters in the
Services.yaml
file - matomo_widgets.visitsPerMonth.parameters:
- period: month
- Date: last12