---
title: "Configuration"
manual: "TYPO3 Analytics"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3g/analytics:configuration@main"
source: "Configuration/Index.rst"
rendered: "2026-09-21T10:47:42+00:00"
---

# Configuration {#configuration}

The following settings can be configured in the TYPO3 Extension Manager under
**Admin Tools → Settings → Extension Configuration → analytics**.

They can also be set programmatically in `config/system/additional.php`:

```php
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['analytics']['settingName'] = 'value';
```

-   **dashboardPeriods**

    -   *Type:* string
    -   *Default:* `7,14,30`

    Comma-separated list of period options (in days) available in all
    dashboard widget dropdowns and the Page Performance Bar. Must be
    positive integers.

-   **dashboardDefaultPeriod**

    -   *Type:* int
    -   *Default:* `7`

    Pre-selected period (in days) for all dashboard widgets and the Page
    Performance Bar. Must be one of the values defined in
    [dashboardPeriods](https://docs.typo3.org/permalink/t3g/analytics:confval-dashboardperiods@main).

-   **pageAnalyticsCacheTtl**

    -   *Type:* int
    -   *Default:* `3600`

    Lifetime in seconds for all analytics data caches (page metrics,
    top pages, site performance, traffic graph, traffic sources, and plans).
    Increase this value to reduce API calls on high-traffic backend
    installations.

-   **demoData**

    -   *Type:* bool
    -   *Default:* `0`

    When enabled, replaces all analytics API calls with static demo data.
    Only takes effect in the TYPO3 `Development` application context.
    Use this to explore the widgets and module without a live analytics
    account.

## Dashboard settings {#dashboard-settings}

**Example — custom period options:**

```php
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['analytics']['dashboardPeriods'] = '7,30,90';
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['analytics']['dashboardDefaultPeriod'] = 30;
```

## Cache settings {#cache-settings}

**Example — longer cache lifetime:**

```php
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['analytics']['pageAnalyticsCacheTtl'] = 7200;
```

## Development settings {#development-settings}

**Example — enable demo data:**

```php
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['analytics']['demoData'] = true;
```
