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. A link to the corresponding page in Matomo is displayed via in icon in the header bar of the widget if the report is available.

Tip

Do you miss a widget? Open a feature request and with a little luck 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

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

Widget Actions per month

Matomo module
VisitsSummary
Default configuration parameters in the Services.yaml file
matomo_widgets.actionsPerMonth.parameters
  • period: month
  • date: last12

Annotations

New in version 1.2.0.

Display a list of the recent annotations in the last 365 days:

Widget Annotations

Widget Annotations

Matomo module
Annotations
Default configuration parameters in the Services.yaml file
matomo_widgets.annotations.parameters
  • period: ‘month’
  • date: ‘today’
  • lastN: 365

Create annotation

New in version 1.3.0.

This widget provides a form to create an annotation conveniently from the TYPO3 backend:

Widget Create annotation

Widget Create annotation

After submitting the form, a notification is displayed in the upper right corner of the browser window. If the creation of the annotation was successful, the Note field will be cleared.

Matomo module
Annotations

Note

The annotation is stored in Matomo under the user configured in the site configuration. A log entry has been created that can be viewed in the System > Log module. In addition to the user, the date, the note and the note ID received are saved:

Entry in the administration log

Entry in the administration log

Note

For the creation of an annotation the according Matomo user needs only the view permission.

Bounce rate

The bounce rate for the current month shows this widget:

Widget Bounce Rate

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

Browser plugins

This report shows which browser plugins your visitors had enabled:

Widget Browser Plugins

Widget Browser Plugins

Matomo module
DevicePlugins
Default configuration parameters in the Services.yaml file
matomo_widgets.browserPlugins.parameters
  • period: month
  • date: today
  • filter_limit: 50
  • filter_sort_column: nb_visits
  • filter_sort_order: desc

Browsers

The browser share for the current month shows this widget:

Widget Browsers

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

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

Content names

The content name report is part of content tracking. The widget displays the names, impressions and interaction rate of the content the visitors viewed and interacted with.

Widget Content Names

Widget Content Names

Matomo module
Contents
Default configuration parameters in the Services.yaml file
matomo_widgets.campaigns.parameters:
  • period: month
  • date: today
  • filter_limit: 50
  • filter_sort_column: nb_impressions
  • filter_sort_order: desc

Content pieces

The content piece report is part of content tracking. The widget displays the pieces, impressions and interaction rate of the content the visitors viewed and interacted with.

Widget Content Pieces

Widget Content Pieces

Matomo module
Contents
Default configuration parameters in the Services.yaml file
matomo_widgets.campaigns.parameters:
  • period: month
  • date: today
  • filter_limit: 50
  • filter_sort_column: nb_impressions
  • filter_sort_order: desc

Countries

Shows a list of countries from which the website was visited in the current month:

Widget Countries

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

Custom dimensions

With custom dimensions any custom data can be assigned to visitors or actions. Before a custom dimension can be used as a dashboard widget it has to be configured for a site.

The columns for a custom dimension widget depend on the scope of the custom dimension.

Matomo module
CustomDimensions
Default configuration parameters in the Services.yaml file
matomo_widgets.customDimension<idDimension>.parameters:
  • period: month
  • date: today
  • filter_limit: 50
  • filter_sort_column: nb_visits
  • filter_sort_order: desc

The <idDimension> is the id of the custom dimension as available in the Matomo configuration.

Scope “action”

Example widget for a custom dimension with scope "action"

Example widget for a custom dimension with scope “action”

Scope “visit”

Example widget for a custom dimension with scope "visit"

Example widget for a custom dimension with scope “visit”

JavaScript errors

New in version 1.3.0.

Displays a list of JavaScript errors that occurred in the last 14 days:

Widget JavaScript errors

Widget JavaScript errors

Clicking on the message opens a modal with details to this message:

Modal with details for a specific error

Modal with details for a specific error

Matomo module
Events
Default configuration parameters in the Services.yaml file
matomo_widgets.javaScriptErrors.parameters:
  • period: range
  • date: last14
  • filter_limit: 50
  • filter_sort_column: nb_events
  • filter_sort_order: desc

Note

To use this widget, JavaScript error tracking must be activated. This can be done either by adding the enableJSErrorTracking code or by enabling the corresponding option in the installed Matomo Integration extension.

Operating system families

The operating system families used by the visitors for the current month:

Widget Operating system families

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

Pages not found

New in version 1.3.0.

List of pages in the last 28 days which returned a status code 404 (not found):

Widget Pages not found

Widget Pages not found

Matomo module
Actions
Default configuration parameters in the Services.yaml file
matomo_widgets.siteSearchKeywords.parameters:
  • period: range
  • date: last28
  • filter_limit: 50
  • filter_sort_column: nb_hits
  • filter_sort_order: desc

Site search keywords

Overview of the search keywords that visitors searched for on the internal search engine:

Widget Site search keywords

Widget Site search keywords

Matomo module
Actions
Default configuration parameters in the Services.yaml file
matomo_widgets.siteSearchKeywords.parameters:
  • period: month
  • date: today
  • filter_limit: 50
  • filter_sort_column: nb_visits
  • filter_sort_order: desc

Site search keywords with no result

List of the site search keywords that did not return any search result:

Widget Site search keywords with no result

Widget Site search keywords with no result

Matomo module
Actions
Default configuration parameters in the Services.yaml file
matomo_widgets.siteSearchNoResultKeywords.parameters:
  • period: month
  • date: today
  • filter_limit: 50
  • 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

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

Widget Visits per month

Matomo module
VisitsSummary
Default configuration parameters in the Services.yaml file
matomo_widgets.visitsPerMonth.parameters:
  • period: month
  • date: last12