--- title: "Matomo connection guide" slug: "matomo-connection-guide" description: "Connect your Matomo data to Supermetrics with our guide. Learn about permissions, authentication tokens, and query types for seamless integration." updated: 2026-10-14T08:06:52Z published: 2026-10-14T08:06:52Z canonical: "docs.supermetrics.com/matomo-connection-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt > Use this file to discover all available pages before exploring further. # Matomo connection guide This guide contains all permissions and requirements for connecting your Matomo data to Supermetrics. You can connect to data sources from the [Data sources page on the Supermetrics Hub](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-authentication-link) to connect to a data source you don't have direct access to. After you connect to the data source on the Hub, you can use the data source connection in [all available destinations](/docs/matomo-connection-guide#connection-instructions). ## Required permissions To connect your Matomo account to Supermetrics, you need your Matomo base URL and your authentication token. These instructions apply to both Matomo cloud-based version and on-premise installation. ****Get your base URL**** 1. Log in to Matomo and open your dashboard. 2. Take a look at the URL in your address bar. 3. The first part of the URL before `index.php` is your base URL to use for login, for example: `https://yourcompany.matomo.cloud`. Make sure that the URL includes the `https://` in front of it. The base URL must be publicly accessible. If you host your own Matomo instance with a custom URL (not the standard Matomo one), it must be publicly accessible on the internet for it to work with our connector. For example, if you set Matomo to require a specific VPN to access it, the base URL won’t work with Supermetrics. ****Get your authentication token**** 1. Log in to Matomo, and open your dashboard. 2. On the upper right-hand side, click the cogwheel icon to get to the **Administration** page. 3. On the left-hand side, under **Personal**, click **Security**. 4. Scroll down to the **Auth tokens** section and click **Create new token**. 5. Enter your password to continue. 6. Enter a description for the token, for example, “Supermetrics”. 7. Click **Create token**. 8. Copy the token and store it in a secure place for later. ## Query types Query types define what sort of metrics and dimensions are available. Set up your Matomo queries using any of the query types described below. ****Reference list: Matomo query types**** - Visitors - **Visitors: Overview**: Engagement metrics for the whole website. - **Visitors: Country**: Engagement metrics by country. - **Visitors: Language**: Engagement metrics by web browser language. - **Visitors: Device type**: Engagement metrics by device type. - Behaviour - **Behaviour: Pages**: Engagement metrics by specific website pages. - **Behaviour: Site search keywords**: Site searches by keyword - **Behaviour: Outlinks**: Clicks by outlink on site. - **Behaviour: Downloads**: Downloads by URL. - **Behaviour: Events**: Engagement metrics by event. - Acquisition - **Acquisition: Channel types**: Acquisition and engagement metrics by channel type. - **Acquisition: Referrers**: Acquisition and engagement metrics by specific referrers. - **Acquisition: Campaign names**: Acquisition and engagement metrics by campaigns. - **Acquisition: Campaign keywords**: Acquisition and engagement metrics by keywords used in campaigns. - **Acquisition: Search engines**: Acquisition and engagement metrics by search engine. - **Acquisition: Search keywords**: Acquisition and engagement metrics by search keywords. - Ecommerce - **Ecommerce: Overview**: Overall ecommerce sales for the whole website. - **Ecommerce: Products**: Ecommerce sales by specific products. - Goals - **Goals: Overview**: Performance of custom goals. ## Connection instructions When connecting to Matomo, you need to provide your credentials and select the accounts and query type when prompted. 1. Select the Matomo data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination. 2. Enter your base URL and auth token. 3. Enter a name for your account for you to identify it later. 4. If prompted, choose to make this connection [shared or private](/v1/docs/about-shared-and-private-connections). 5. Click **Start**. 6. In your data destination, select the accounts to include in your reporting and a query type. See detailed instructions on [how to connect to a data source from the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-supermetrics-hub). You can also connect to Matomo from these destinations: - Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets) - Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio) - Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics) - Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi) - The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager) - Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer) - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer) ## More resources - [How to reauthenticate a data source connection](/v1/docs/how-to-reauthenticate-a-data-source-connection) - [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)