---
title: "Configuration"
manual: "Matomo Integration"
version: "main"
permalink: "https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-integration:configuration@main"
source: "Configuration/Index.rst"
rendered: "2026-09-22T16:58:05+00:00"
---

# Configuration {#configuration}

Target group: **Developers, Integrators**

## Site configuration {#site-configuration}

To configure the extension, go to **Site Management > Sites**
and select the appropriate site configuration. Click on the **Matomo
Integration** tab:

![Options in the site configuration](../Images/site-configuration.png)

> [!WARNING]
> **Attention**
>
> After you have adjusted the settings in the site configuration,
> you must flush the cache.

> [!NOTE]
> The Matomo integration is only active, if a URL and a site ID are specified.

### Installation {#installation}

-   **URL**

    Enter the URL of your Matomo instance (without `matomo.php` at the end).
    Relative URLs can be used, like `//matomo.example.com/`.

-   **Site ID**

    Enter the site ID for the website.

### Options {#site-configuration-track-error-pages}

> [!NOTE]
> The initial status of the options corresponds to the default JavaScript
> tracking code specified via the menu **Administration > Measurables**
> in Matomo.

-   **Track users with JavaScript disabled**

    If this option is enabled, users with JavaScript disabled will be tracked.
    Technically, a `<noscript>` tag is embedded in the web page.

    Default: *disabled*

-   **Require consent**

    shield-check Activating this option has a **positive** impact on privacy.

    Enable this option when a consent manager is used which sets up consent
    tracking: no tracking request will be sent to Matomo and no cookies will be
    set. For more information have a look into
    [Implementing tracking or cookie consent with the Matomo JavaScript Tracking Client](https://developer.matomo.org/guides/tracking-consent).

    Default: *disabled*

-   **Require cookie consent**

    shield-check Activating this option has a **positive** impact on privacy.

    Enable this option when a consent manager is used which sets up consent
    tracking: tracking requests will still be sent but no cookies will be set.
    For more information have a look into
    [Implementing tracking or cookie consent with the Matomo JavaScript Tracking Client](https://developer.matomo.org/guides/tracking-consent).

    Default: *disabled*

    > [!IMPORTANT]
    > When enabling this option *and* the option "Require consent", "Require
    > cookie consent" will be ignored in favour of the more restrictive one.

-   **Use tracking cookies**

    shield-alert Activating this option has a **negative** impact on privacy.

    Activating this option [enables cookies tracking](https://matomo.org/faq/general/faq_157/).

    See also [When cookies are disabled by a visitor (cookieless tracking), how does it impact Matomo reports accuracy?](https://matomo.org/faq/general/faq_156/)

    Default: *enabled*

-   **File tracking**

    shield-alert Activating this option has a **negative** impact on privacy.

    This option has been introduced with Matomo 5 and enables the
    [file:// protocol tracking](https://matomo.org/faq/how-to/enable-file-protocol-tracking/).

    Default: *disabled*

    > [!WARNING]
    > **Attention**
    >
    > Enabling this option may track personal data: Someone downloads a page
    > from your website and stores it locally. Then the user opens it and the
    > user will be tracked. The URL might look like
    > `file:///C:/Users/myname/AppData/Local/...`

-   **Link tracking**

    This option enables the [download and outlink tracking](https://matomo.org/faq/new-to-piwik/faq_71/).

    Default: *enabled*

-   **Performance tracking**

    This option enables the [tracking of performance data](https://matomo.org/faq/how-to/how-do-i-see-page-performance-reports/).

    Default: *enabled*

-   **Heart beat timer**

    Enable this option when you want to [accurately measure the time spent](https://matomo.org/faq/how-to/faq_21824/) in
    the visit.

    Default: *disabled*

-   **Disable browser feature detection**

    shield-check Activating this option has a **positive** impact on privacy.

    This option [disables the browser feature detection](https://matomo.org/faq/how-to/how-do-i-disable-browser-feature-detection-completely/).

    Default: *disabled* (browser features are detected)

-   **Disable campaign parameters**

    shield-check Activating this option has a **positive** impact on privacy.

    By default, Matomo will send campaign parameters (mtm, utm, etc.) to the
    tracker and record that information. Some privacy regulations may not allow
    for this information to be collected. If this applies to you, activate this
    method to prevent campaign parameters from being sent to the tracker.

    Default: *disabled* (campaign parameters are sent)

-   **Respect "Do not track" browser setting**

    This option prevents requests and cookies when people
    [don't want to be tracked](https://matomo.org/faq/general/configure-privacy-settings-in-matomo/#step-4-respect-donottrack-preference).

    Default: *disabled*

-   **Track all content impressions**

    If you use [content tracking](https://matomo.org/guide/reports/content-tracking/) you can enable this option when you want to
    track **all** content impressions on a page.

    Default: *disabled*

-   **Track visible content impressions**

    If you use [content tracking](https://matomo.org/guide/reports/content-tracking/) you can enable this option when you want to track
    **visible** content impressions on a page.

    Default: *disabled*

-   **Track error pages**

    If you have configured the [error handling](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/ErrorHandling/Index.html#sitehandling-errorHandling) and enable this option, the document
    title will be set as described in the Matomo FAQ:
    [How to track error pages](https://matomo.org/faq/how-to/faq_60/). You can customise the document title in the
    field ["Document title template for tracking of error pages"](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-integration:site-configuration-error-pages-template@main)

    Default: *disabled*

    > [!NOTE]
    > If you have configured multiple error status codes with the same page ID,
    > the first defined error code will be used.

-   **Track JavaScript errors**

    With this option enabled [JavaScript errors](https://matomo.org/faq/how-to/how-do-i-enable-basic-javascript-error-tracking-and-reporting-in-matomo-browser-console-error-messages/) are tracked.

    Default: *disabled*

    > [!NOTE]
    > Only JavaScript errors that occur after the asynchronous loading and
    > execution of the Matomo script will be tracked.

-   **Document title template for tracking of error pages**

    Adapt the template for the document title to your needs with the option
    ["Track error pages"](https://docs.typo3.org/permalink/brotkrueml/typo3-matomo-integration:site-configuration-track-error-pages@main)
    enabled. You can use the following variables:

    -   **`{statusCode}`**

        The status code of the error (for example, 404, 500).

    -   **`{path}`**

        The path of the URL where the error occurred.

    -   **`{referrer}`**

        The referrer.

    Default: *{statusCode}/URL = {path} /From = {referrer}*

### Tag Manager {#site-configuration-tag-manager-container-ids}

-   **Container IDs**

    If you use the [Matomo Tag Manager](https://matomo.org/guide/tag-manager/), enter the container IDs in this field.
    If no value is given, the tag manager code will not be embedded in the web
    page.

    Default: *empty string*

    Examples for possible values:

    -   Live: `l2UO6eVk`
    -   Dev: `l2UO6eVk_dev_600e4be39a8bfd98bf71f295`
    -   Staging: `l2UO6eVk_staging_6584c7e4727fcb9180530d6d`

    Multiple container IDs can be configured, separated by a comma, for example:
    `l2UO6eVk,gu8CuJ6Q`.

> [!TIP]
> **Hint**
>
> It is possible to define different container IDs for different environments
> (such as Live, Dev, Staging) using [environment variables](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ApiOverview/SiteHandling/UsingEnvVars.html#sitehandling-using-env-vars).

-   **Debug Mode**

    When [debug mode](https://developer.matomo.org/guides/tagmanager/debugging#developer-console-log-messages) is enabled, various debug messages are logged on the
    developer console.

    Default: *disabled*