Matomo connection guide

  • Updated on Jul 16, 2025
  • Published on Jun 25, 2025
Prev Next

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. On the Hub, you can also share an 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.

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

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 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.

  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.

You can also connect to Matomo from these destinations:

More resources