---
title: "Introduction"
manual: "Matomo Widgets"
version: "main"
permalink: "https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:introduction@main"
source: "Introduction/Index.rst"
rendered: "2026-09-22T16:06:29+00:00"
---

# Introduction {#introduction}

**Table of Contents**

-   [What does it do?](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:what-does-it-do@main)
-   [Screenshots](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:screenshots-1@main)
-   [No Matomo instance at hand?](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:no-matomo-instance-at-hand@main)
-   [Release management](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:release-management-1@main)

## What does it do? {#what-it-does}

The extension provides charts for various [Matomo](https://www.matomo.org/) reports via the
[Reporting API](https://developer.matomo.org/guides/querying-the-reporting-api).

The default parameters of the widgets can be adjusted to your needs, for
example, in the *Visits per month* widget display 24 month instead of 12 months.

> [!TIP]
> The [Matomo Integration](https://docs.typo3.org/p/brotkrueml/typo3-matomo-integration/main/en-us/Introduction/Index.html#introduction) extension
> provides an easy way to integrate Matomo into TYPO3.

## Screenshots {#screenshots}

![Example for a Matomo Dashboard](../Images/DashboardExample.jpg)

## No Matomo instance at hand? {#no-matomo-instance-at-hand}

You can use the Matomo demo installation for evaluation. Just enter the
following settings into the [site configuration](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:site-configuration@main):

-   **Base URL of the Matomo instance**

    [https://demo.matomo.cloud/](https://demo.matomo.cloud/)

-   **Site ID**

    1

-   **Authentication token**

    (leave empty)

## Release management {#release-management}

This extension uses [semantic versioning](https://semver.org/) which basically means for you, that

-   Bugfix updates (for example, 1.0.0 => 1.0.1) just includes small bug fixes or
    security relevant stuff without breaking changes.
-   Minor updates (for example, 1.0.0 => 1.1.0) includes new features and smaller
    tasks without breaking changes.
-   Major updates (for example, 1.0.0 => 2.0.0) breaking changes which can be
    refactorings, features or bug fixes.

The changes between the different versions can be found in the
[changelog](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-widgets:changelog@main).