> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQs

> Common questions, expected behaviors, and troubleshooting for the Matomo data source.

Answers to common questions about expected behaviors and workarounds for the Matomo data source.

## What is the difference between self-hosted Matomo and Matomo Cloud in Adriel?

There is no difference in how the data is handled. Adriel does not distinguish between self-hosted Matomo and Matomo Cloud — both are reached through the same Matomo Reporting API, and only the instance URL differs. The same metrics and breakdowns are available in either case, and reporting behaves identically once the data source is connected.

## Why is my Users metric zero?

The Users metric counts unique active visitors that have a known User ID. Matomo populates it only when the tracked site sends a User ID with visits. If the Matomo instance is not configured for User ID tracking, the metric reports zero even though visits and unique visitors have values. To report on identified users, enable User ID tracking on the Matomo site; existing visits recorded before that change will not be back-filled with User IDs.

## Why do some ecommerce metrics only appear after I set up tracking?

Several ecommerce metrics depend on Matomo's ecommerce product and category page tracking. Conversion rate, product and category performance, and related values appear only when that tracking is configured on the site. Abandoned-cart metrics have the same dependency. Until ecommerce tracking is enabled in Matomo, those metrics have no underlying data to return and stay empty in widgets.

## How do I report on more than one Matomo site?

Each Matomo data source is scoped to a single tracked site. To report on more than one site, connect an additional data source for each site and add them to the dashboard. A single widget can pull from multiple data sources, so several sites can be compared side by side once each one is connected. For the connection steps, see [How to connect Matomo](/data-sources/g-n/matomo/how-to-connect).

## Why can't I combine Matomo with other data sources in one widget?

Matomo data is provided as a generic table. It combines directly with other data sources that share the same breakdowns, such as another web-analytics connector reporting on country or device. To blend it with sources that do not share those breakdowns — for example an ad platform — blend settings need to be configured so the breakdowns line up. Without matching breakdowns or blend settings, the sources cannot be aggregated in the same widget.

## Why is my data cut off on a long date range?

Matomo reports are queried live from the instance, and the time groupings have range caps. The Daily grouping is limited to 93 days and the Weekly grouping to 1 year; data outside those windows may be truncated. For a longer continuous view, use a coarser grouping such as Monthly, Quarterly, or Yearly, which has no connector-side cap. See the [Matomo data reference](/data-sources/g-n/matomo/data-reference) for the full list of limits.

## Related

<CardGroup cols={2}>
  <Card title="Matomo data reference" href="/data-sources/g-n/matomo/data-reference">
    Metrics, breakdowns, and limits for the Matomo data source.
  </Card>

  <Card title="How to connect Matomo" href="/data-sources/g-n/matomo/how-to-connect">
    Connect a Matomo site and select the tracked site to report on.
  </Card>

  <Card title="Google Analytics 4 data reference" href="/data-sources/g-n/google-analytics-4/data-reference">
    The alternative web-analytics connector and its fields.
  </Card>

  <Card title="Refresh strategies" href="/data-sources/how-data-works/refresh-strategies">
    How Adriel keeps data source values up to date.
  </Card>
</CardGroup>