--- title: "Widgets" manual: "Matomo Widgets" version: "main" permalink: "https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:widgets@main" source: "Widgets/Index.rst" rendered: "2026-09-22T16:06:29+00:00" --- # Widgets {#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](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:site-configuration@main) and the permissions for editors have to be granted to be able to use these widgets. > [!TIP] > **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](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:widget-configuration@main) 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. - [Actions per day](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:actions-per-day@main) - [Actions per month](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:actions-per-month@main) - [AI assistants](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:ai-assistants@main) - [Annotations](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:annotations@main) - [Conversions per month](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:conversions-per-month@main) - [Create annotation](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:create-annotation@main) - [Bounce rate](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:bounce-rate@main) - [Browser plugins](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:browser-plugins@main) - [Browsers](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:browsers@main) - [Campaigns](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:campaigns@main) - [Content names](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:content-names@main) - [Content pieces](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:content-pieces@main) - [Countries](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:countries@main) - [Custom dimensions](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:custom-dimensions@main) - [JavaScript errors](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:javascript-errors@main) - [Link to Matomo](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:link-to-matomo@main) - [Most viewed pages](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:most-viewed-pages@main) - [Operating system families](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:operating-system-families@main) - [Pages not found](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:pages-not-found@main) - [Site search keywords](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:site-search-keywords@main) - [Site search keywords with no result](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:site-search-keywords-with-no-result@main) - [Visits per day](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:visits-per-day@main) - [Visits per month](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:visits-per-month@main) > [!TIP] > Do you miss a widget? Open a [feature request](https://github.com/brotkrueml/typo3-matomo-widgets/issues) and with a little luck the > widget is available in the next release. ## Actions per day {#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](../Images/WidgetActionsPerDay.png) - **Matomo module** VisitsSummary - **Active widgets value in `config.yaml`** actionsPerDay - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.actionsPerDay.parameters** - period: day - date: last28 ## Actions per month {#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](../Images/WidgetActionsPerMonth.png) - **Matomo module** VisitsSummary - **Active widgets value in `config.yaml`** actionsPerMonth - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.actionsPerMonth.parameters** - period: month - date: last12 ## AI assistants {#ai-assistants} > [!NOTE] > Please ensure that you use at least Matomo in version 5.5. The AI assistants for the last 28 days shows this widget: ![Widget AI Assistants](../Images/WidgetAiAssistants.png) - **Matomo module** Referrers - **Active widgets value in `config.yaml`** aiAssistants - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.aiAssistants.limit** 5 - **matomo_widgets.aiAssistants.parameters** - period: range - date: last28 - filter_sort_column: nb_visits - filter_sort_order: desc ## Annotations {#annotations} Display a list of the recent [annotations](https://matomo.org/docs/annotations/) in the last 365 days: ![Widget Annotations](../Images/WidgetAnnotations.png) - **Matomo module** Annotations - **Active widgets value in `config.yaml`** annotations - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.annotations.parameters** - period: 'month' - date: 'today' - lastN: 365 ## Conversions per month {#conversions-per-month} This widget displays the number of conversions per month for the last 12 months (including the current month). For this, you have to define at least one [goal](https://matomo.org/guide/reports/goals-and-conversions/). ![Widget Conversions per month](../Images/WidgetConversionsPerMonth.png) - **Matomo module** Goals - **Active widgets value in `config.yaml`** conversionsPerMonth - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.conversionsPerMonth.parameters** - period: month - date: last12 ## Create annotation {#create-annotation} This widget provides a form to create an [annotation](https://matomo.org/docs/annotations/) conveniently from the TYPO3 backend: ![Widget Create annotation](../Images/WidgetCreateAnnotation.png) 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 - **Active widgets value in `config.yaml`** createAnnotation > [!NOTE] > The annotation is stored in Matomo under the user configured in the > [site configuration](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:site-configuration@main). 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](../Images/AdministrationLogEntry.png) > [!NOTE] > For the creation of an annotation the according Matomo user needs only the > `view` permission. ## Bounce rate {#widgets-bounce-rate} The bounce rate for the last 28 days shows this widget: ![Widget Bounce Rate](../Images/WidgetBounceRate.png) - **Matomo module** VisitsSummary - **Active widgets value in `config.yaml`** bounceRate - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.bounceRate.parameters** - period: range - date: last28 - **matomo_widgets.bounceRate.subtitle** in the last 28 days (incl. today) ## Browser plugins {#widgets-browser-plugins} This report shows which browser plugins your visitors had enabled in the last 28 days: ![Widget Browser Plugins](../Images/WidgetBrowserPlugins.png) - **Matomo module** DevicePlugins - **Active widgets value in `config.yaml`** browserPlugins - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.browserPlugins.parameters** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_visits - filter_sort_order: desc ## Browsers {#widgets-browsers} The browser share for the last 28 days shows this widget: ![Widget Browsers](../Images/WidgetBrowsers.png) - **Matomo module** DevicesDetection - **Active widgets value in `config.yaml`** browsers - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.browsers.limit** 5 - **matomo_widgets.browsers.parameters** - period: range - date: last28 - filter_sort_column: nb_visits - filter_sort_order: desc ## Campaigns {#widgets-campaigns} Displays a report of the campaigns for the last 28 days: ![Widget Campaigns](../Images/WidgetCampaigns.png) - **Matomo module** Referrers - **Active widgets value in `config.yaml`** campaigns - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.campaigns.parameters:** - period: range - date: last28 - filter_limit: 30 - filter_sort_column: nb_visits - filter_sort_order: desc ## Content names {#widgets-content-names} The content name report is part of [content tracking](https://matomo.org/docs/content-tracking/). The widget displays the names, impressions and interaction rate of the content the visitors viewed and interacted with. ![Widget Content Names](../Images/WidgetContentNames.png) - **Matomo module** Contents - **Active widgets value in `config.yaml`** contentNames - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.campaigns.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_impressions - filter_sort_order: desc ## Content pieces {#widgets-content-pieces} The content piece report is part of [content tracking](https://matomo.org/docs/content-tracking/). The widget displays the pieces, impressions and interaction rate of the content the visitors viewed and interacted with. ![Widget Content Pieces](../Images/WidgetContentPieces.png) - **Matomo module** Contents - **Active widgets value in `config.yaml`** contentPieces - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.campaigns.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_impressions - filter_sort_order: desc ## Countries {#widgets-countries} Shows a list of countries from which the website was visited in the last 28 days: ![Widget Countries](../Images/WidgetCountries.png) - **Matomo module** UserCountry - **Active widgets value in `config.yaml`** countries - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.country.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_visits - filter_sort_order: desc ## Custom dimensions {#widgets-custom-dimensions} With [custom dimensions](https://matomo.org/docs/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](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:configuring-custom-dimensions@main). The columns for a custom dimension widget depend on the scope of the custom dimension. - **Matomo module** CustomDimensions - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.customDimension\.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_visits - filter_sort_order: desc The `` is the ID of the custom dimension as available in the [Matomo configuration](https://matomo.org/docs/custom-dimensions/#creating-custom-dimensions). ### Scope "action" {#scope-action} ![Example widget for a custom dimension with scope "action"](../Images/WidgetCustomDimensionAction.png) ### Scope "visit" {#scope-visit} ![Example widget for a custom dimension with scope "visit"](../Images/WidgetCustomDimensionVisit.png) ## JavaScript errors {#javascript-errors} Displays a list of JavaScript errors that occurred in the last 14 days: ![Widget JavaScript errors](../Images/WidgetJavaScriptErrors.png) Clicking on the message opens a modal with details to this message: ![Modal with details for a specific error](../Images/WidgetJavaScriptErrorsDetailsModal.png) - **Matomo module** Events - **Active widgets value in `config.yaml`** javaScriptErrors - **Default configuration parameters in the `Configuration/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](https://matomo.org/faq/how-to/how-do-i-enable-basic-javascript-error-tracking-and-reporting-in-matomo-browser-console-error-messages/) code or by enabling the > corresponding option in the installed [Matomo Integration extension](https://docs.typo3.org/p/brotkrueml/typo3-matomo-integration/main/en-us/Configuration/Index.html#site-configuration). ## Link to Matomo {#link-to-matomo} A call-to-action widget is used to show a link to the configured Matomo installation: ![Widget Link to Matomo](../Images/WidgetLinkToMatomo.png) - **Active widgets value in `config.yaml`** linkMatomo ## Most viewed pages {#widgets-most-views-pages} Show the most viewed pages of a site for the last 28 days: ![Widget Most viewed pages](../Images/WidgetMostViewedPages.png) - **Matomo module** Actions - **Active widgets value in `config.yaml`** mostViewedPages - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.mostViewedPages.parameters:** - period: range - date: last28 - filter_sort_column: nb_hits - filter_sort_order: desc > [!TIP] > When you see URLs with the addition "- Others" then Matomo groups pages > automatically after a given limit: You can [increase the limit](https://matomo.org/faq/how-to/faq_54/). Maybe you > want then [invalidate the historical reports](https://matomo.org/faq/how-to/faq_155/) to adopt the change. ## Operating system families {#widgets-operating-system-families} The operating system families used by the visitors for the last 28 days: ![Widget Operating system families](../Images/WidgetOsFamilies.png) - **Matomo module** DevicesDetection - **Active widgets value in `config.yaml`** osFamilies - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.osFamilies.limit:** 5 - **matomo_widgets.osFamilies.parameters:** - period: range - date: last28 - filter_sort_column: nb_visits - filter_sort_order: desc ## Pages not found {#pages-not-found} List of pages in the last 28 days which returned a status code 404 (not found): ![Widget Pages not found](../Images/WidgetPagesNotFound.png) - **Matomo module** Actions - **Active widgets value in `config.yaml`** pagesNotFound - **Default configuration parameters in the `Configuration/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 {#widgets-operating-site-search-keywords} Overview of the search keywords that visitors searched for on the internal search engine: ![Widget Site search keywords](../Images/WidgetSiteSearchKeywords.png) - **Matomo module** Actions - **Active widgets value in `config.yaml`** siteSearchKeywords - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.siteSearchKeywords.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_visits - filter_sort_order: desc ## Site search keywords with no result {#widgets-operating-site-search-keywords-no-result} List of the site search keywords that did not return any search result: ![Widget Site search keywords with no result](../Images/WidgetSiteSearchNoResultKeywords.png) - **Matomo module** Actions - **Active widgets value in `config.yaml`** siteSearchNoResultKeywords - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.siteSearchNoResultKeywords.parameters:** - period: range - date: last28 - filter_limit: 50 - filter_sort_column: nb_visits - filter_sort_order: desc ## Visits per day {#visits-per-day} This widget displays the number of visits per day for the last 28 days: ![Widget Visits per day](../Images/WidgetVisitsPerDay.png) - **Matomo module** VisitsSummary - **Active widgets value in `config.yaml`** visitsPerDay - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.visitsPerDay.parameters:** - period: day - date: last28 ## Visits per month {#visits-per-month} This widget displays the number of visits per month for the last 12 months: ![Widget Visits per month](../Images/WidgetVisitsPerMonth.png) - **Matomo module** VisitsSummary - **Active widgets value in `config.yaml`** visitsPerMonth - **Default configuration parameters in the `Configuration/Services.yaml` file** - **matomo_widgets.visitsPerMonth.parameters:** - period: month - date: last12