# Guide: Using Matomo with Databox

## How to connect Matomo to Databox

![](/assets/guide-using-matomo-with-databox_1.3dcc62231cb5eb859729405c55baa310c8bac2afdbaca4bc6eb07930a03ae26b.4783b0ec.gif)

To connect a Matomo Account in Databox, go to  **Data Manager > + New connection.** Type**Matomo** in the search bar and click on the green **Connect**button. Next, click the green **Connect now** button.

This will open the   **Authorization** window, which is where you will be prompted to enter your **Matomo** Token and Website URL.

![](/assets/guide-using-matomo-with-databox_2.a23d7dd618572ee857f40752c044c83721b296acc962030d699da615d5ee9c64.4783b0ec.png)

To generate a Token in Matomo, follow the steps below:

1. Login to your Matomo Account
2. Click on the  **Settings** in the top menu and navigate to the **Matomo Admin**
3. Next, click on the  **Personal > Security** and scroll down to the **Auth token** section
4. Click on the  **Create New Token**and confirm your account password
5. In the description field, type in your purpose for this token
6. Click on the  **Create New Token**
7. Once the token has been generated, enter it in the Databox's Activation window


Save your Matomo Token generated for the Databox app somewhere safe, as you won't be able to access it after leaving that screen your Matomo account. If you lose it, you will need to generate a new token.

Next, to find the Website URL in Matomo, follow the steps below:

1. Login to your Matomo Account and copy the **URL** from your login page ![](/assets/guide-using-matomo-with-databox_3.a71412acaca542239d7d8c9f489a3e8cbd878f37797cf8811a75b51c41bc1736.4783b0ec.png)
2. The URL will look similar to '' [https://www.subdomain.domain.com](https://www.subdomain.domain.com/)''. Copy only the URL's Domain name:  **"subdomain.domain.com"**.
3. Paste the **Domain name** (e.g., subdomain.domain.com) in the Databox's Activation window


Once you have entered the Token Auth and the Domain name in Databox, click **Activate** to authorize the Databox app. A pop-up with eligible websites will open. Select the website you want to connect to Databox, and click the green **Continue**button to complete the connection process.

Each Matomo Account must be connected as a separate Data Source in Databox (1 Account = 1 Data Source). Learn more [here](/add-a-connection)

## What's the maximum amount of historical data initially available when you use a new Matomo Data Source Metric in Databox?

Data is synced for the Metrics that are being used in your Account, so when you first use a new Matomo Metric, the maximum amount of historical data available is 36 months.

For more information about the amount of historical data available for a specific Metric, please contact our Support Team via live chat or at [help@databox.com](mailto:help@databox.com).

In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more [here](/data-sync-storage-security-in-databox).
The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more [here](/choose-a-subscription-plan).

## What time zone does Matomo data sync in?

Matomo data is synced in UTC. You can also select your own time zone set in the Matomo Account.

If multiple time zones are selected in the Matomo account, you won't be able to connect. It is therefore recommended that you should only select UTC in your account, so the data can sync with Databox.

## How often does Matomo data sync?

All Matomo Data Sources will sync every hour with Databox. Learn more [here](/data-sync-storage-security-in-databox).

## How to build a Databoard using Matomo data

![](/assets/guide-using-matomo-with-databox_4.d89a71f83b8e3fcd7afe0be5f86c91703a0b3eb858b610436f44610aea5e9d15.4783b0ec.gif)

1. Navigate to  **Databoards** > **+ New Databoard** > **Start Blank**
2. Click on the **Metric Library** icon on the left-hand side of the Designer
3. Select the appropriate Matomo Account from the **Data Source** drop-down list in the **Metric Library**
4. View the list of pre-built Matomo Datablocks in the **Metric Library**. Drag and drop your selected Datablock onto your Databoard
5. If a pre-built Datablock isn't available for your use case, click on the **Visualization Types** icon under the Metric Library icon
6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
7. Click on the Datablock on the Databoard to open the corresponding **Datablock Editor**on the right-hand side of the Designer
8. In the  **Metrics** drop-down, click  **Data Source** to select the appropriate Data Source. This will filter out metrics from the specific Data Source.
9. In the main **Metrics** drop-down, select the metric you'd like to display on the Datablock, using the Search bar if needed. This will update the Datablock, and it will populate with the corresponding data
10. Complete steps 4-9 until your Databoard is complete


## How to use the Metric Builder for Matomo

With the Metric Builder for Matomo, you can create Custom Matomo Metrics using a combination of Metrics, Dimensions, and Filters. Some popular use cases for the Metric Builder for Matomo include tracking Standard Report and Dimension Report data.

Learn more about the Metric Builder for Matomo [here](/master-overview-metric-builders-for-matomo).

## Metric Considerations

- Due to technical limitations, the Metric “Unique Visitors” will show the big number on top of the metric for only the first interval. This means that it is not possible to view a “Total” number for a date range on the top of the metric. However, if you will display this metric on a Line chart for example, you will be able to view data for each day separately.
- Due to API limitations, you can only retrieve up to (top) 100 custom dimensions. Learn more about this in their official documentation [here](https://matomo.org/faq/reporting-tools/data-limits-for-custom-dimensions/#:~:text=a%20maximum%20of%20100%20dimensions%20total).
If the desired dimensions (dimensions that do not have any values displayed) are not in the top 100 based on unique page views, no values are displayed because we get nothing via API.