---
title: "Hotjar connection guide"
slug: "hotjar-connection-guide"
description: "Connect your Hotjar data to Supermetrics with our guide. Learn about permissions, API credentials, and data source connections for effective analytics."
updated: 2026-05-06T11:43:01Z
published: 2026-05-06T13:25:57Z
---

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

# Hotjar connection guide

This guide contains all permissions and requirements for connecting your Horjar 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](/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](/v1/docs/hotjar-connection-guide#connection-instructions).

## Required permissions

Before using the Hotjar connector, make sure that your Hotjar plan includes access to their API. See [this Hotjar support article](https://help.hotjar.com/hc/en-us/articles/36819965653009-How-to-Set-Up-the-Hotjar-API) for information on how to subscribe to API access.

To connect Supermetrics to your Hotjar account, you need to generate API credentials (client ID and client secret) as well as the site ID for the site you want to fetch data for.

****Step 1: Generate API credentials****

1. Log in to the [Hotjar platform](https://insights.hotjar.com).
2. Open the **Organization Settings** page
3. Click **API** from the left menu bar.
4. Select your organization.
5. Enter a name for the credential, for example “Supermetrics”.
6. For scopes, select “Survey responses”.
7. Click **Generate credentials**.
8. Copy the **Client ID** and **Client secret** to a safe place for later reference.

****Step 2: Get your site ID****

1. Log in to the [Hotjar platform](https://insights.hotjar.com).
2. Open the [Sites & Organizations page](https://insights.hotjar.com/site/list).
3. The site ID is in the left-most column in the table, next to the site name.

## Query types

If prompted, you need to select a query type to pull data.

- **Surveys**: Behavior analytics and feedback data to help users empathize and understand their customers through surveys tool.

## Connection instructions

When connecting to Hotjar, you need to provide your API credentials.

1. Select the Hotjar data source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. Enter your client ID, client secret, and site ID.
3. Give a name for your site so you can 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 query type, if prompted

See detailed instructions on [how to connect to a data source from the Supermetrics Hub.](/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub)

You can also connect to Hotjar from these destinations:

- Google Sheets: [How to log in to a Supermetrics data source in Google Sheets](/v1/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets)
- Data Studio: [How to connect data sources to Looker Studio](/v1/docs/how-to-connect-data-sources-to-looker-studio-formerly-data-studio)
- Excel: [How to connect data sources to Excel with Supermetrics](/v1/docs/how-to-connect-data-sources-to-excel-with-supermetrics)
- Power BI: [How to create your first Supermetrics query for Power BI](/v1/docs/how-to-create-your-first-supermetrics-query-for-power-bi)
- The Supermetrics API: [How to use the Query Manager](/v1/docs/how-to-use-the-query-manager)

## More resources

- [How to reauthenticate a data source in Google Sheets, Looker Studio, Excel, or Power BI](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-google-sheets-looker-studio-excel-power-bi-and-supermetrics-hub)
- [How to reauthenticate a data source in data warehouse, API, or cloud storage platform](/v1/docs/how-to-reauthenticate-a-data-source-connection-in-data-warehouse-destinations-or-the-supermetrics-api)
- [How to manage data source connections on the Supermetrics Hub](/v1/docs/how-to-manage-data-source-connections-on-supermetrics-hub)