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

# Troubleshooting {#troubleshooting}

-   [Widgets show "No data available"](https://docs.typo3.org/permalink/t3g/analytics:widgets-show-no-data-available@main)
-   [Tracking script is not injected on the frontend](https://docs.typo3.org/permalink/t3g/analytics:tracking-script-is-not-injected-on-the-frontend@main)
-   [Registration fails or returns an error](https://docs.typo3.org/permalink/t3g/analytics:registration-fails-or-returns-an-error@main)
-   ["Access denied" flash message in the backend module](https://docs.typo3.org/permalink/t3g/analytics:access-denied-flash-message-in-the-backend-module@main)
-   [Page Performance Bar does not appear](https://docs.typo3.org/permalink/t3g/analytics:page-performance-bar-does-not-appear@main)
-   [Dashboard iframe is blank or shows an error](https://docs.typo3.org/permalink/t3g/analytics:dashboard-iframe-is-blank-or-shows-an-error@main)
-   [Tracking has stopped / credits exhausted](https://docs.typo3.org/permalink/t3g/analytics:tracking-has-stopped-credits-exhausted@main)
-   [Demo data does not appear](https://docs.typo3.org/permalink/t3g/analytics:demo-data-does-not-appear@main)
-   [Further assistance](https://docs.typo3.org/permalink/t3g/analytics:further-assistance@main)

## Widgets show "No data available" {#widgets-show-no-data-available}

**Possible causes:**

-   The selected period has no recorded visits yet. Try a longer period
    (e.g. 30 days), or wait until the tracking script has collected data.
-   The cached API response does not yet contain data. The cache TTL is
    controlled by [pageAnalyticsCacheTtl](https://docs.typo3.org/permalink/t3g/analytics:confval-pageanalyticscachettl@main) (default: 1 hour).

## Tracking script is not injected on the frontend {#tracking-script-is-not-injected-on-the-frontend}

The tracking script is injected automatically when a site is successfully
registered. If it is missing:

-   Confirm that registration completed and the site status is **active**.
    A `pending` or `cancelled` status means tracking is not yet live.
-   Make sure no caching layer (reverse proxy, CDN) is serving a stale page
    that was cached before the site was registered.

## Registration fails or returns an error {#registration-fails-or-returns-an-error}

-   Only backend administrators and users with the **Analytics Manager** custom
    option can register sites. See [Access control](https://docs.typo3.org/permalink/t3g/analytics:access-control@main).
-   Verify that the server can reach the TYPO3 Analytics API. Firewall rules or
    outbound proxy configurations may block the request.
-   Check **Admin Tools → Log** for the specific API error returned.

## "Access denied" flash message in the backend module {#access-denied-flash-message-in-the-backend-module}

The action requires the **Analytics Manager** permission. Grant it by opening
**System → Backend Users → Backend Groups**, editing the relevant group,
switching to the **Custom Options** tab, and enabling
**Analytics → Analytics Manager**.

See [Access control](https://docs.typo3.org/permalink/t3g/analytics:access-control@main) for the full list of restricted actions.

## Page Performance Bar does not appear {#page-performance-bar-does-not-appear}

-   The bar is only shown in the **Web → Page** module when a single
    language is selected. It is hidden in language-comparison mode (when
    multiple languages are displayed side by side).
-   The bar loads asynchronously. If the page module loads but the bar never
    appears, open the browser developer tools and check the network tab for a
    failed AJAX request.
-   Confirm the site is registered and its status is **active**.

## Dashboard iframe is blank or shows an error {#dashboard-iframe-is-blank-or-shows-an-error}

-   The iframe URL is retrieved from the TYPO3 Analytics API on each request.
    If the API is unreachable, the iframe cannot be loaded. Check
    **Admin Tools → Log** for API errors.
-   Non-manager backend users receive a read-only dashboard link. This is
    expected behaviour — they can view data but cannot change settings.

## Tracking has stopped / credits exhausted {#tracking-has-stopped-credits-exhausted}

When a site's credits are used up, tracking stops immediately — no further
visits are recorded until the credit balance resets or the plan is upgraded.
The backend module shows a warning on the affected site card.

-   Check the credit usage displayed on the site card.
-   Use the **Manage Plan** link to upgrade the subscription or wait
    for the monthly credit reset (the reset date is shown on the site card).
-   Use the **Refresh status** button to fetch the current credit
    balance bypassing the 24-hour cache, for example to check whether a reset
    has already occurred.

## Demo data does not appear {#demo-data-does-not-appear}

The [demoData](https://docs.typo3.org/permalink/t3g/analytics:confval-demodata@main) setting only takes effect when the TYPO3 application
context is `Development`. If demo data is enabled but the context is
`Production` or `Testing`, the extension falls back to real API calls —
which means no data is shown if the site is not yet registered or has no
recorded visits.

-   Verify the application context is set to `Development`, for example by
    checking the web server environment variable `TYPO3_CONTEXT`.

## Further assistance {#further-assistance}

If your issue is not covered above, contact the TYPO3 Analytics support team
at [support@typo3.com](mailto:support@typo3.com?subject=TYPO3%20Analytics%20Support%20Request).