Hotjar

Hotjar is a popular behavioral analytics platform, suitable for marketing teams and product managers to better understand and improve their product. It allows them to understand the behavior of their website’s visitors through heat maps, surveys, and conversion funnels.

RudderStack helps you integrate your website with Hotjar to auto-track your user data.

Connection compatibility

Destination Information
Status: Generally Available Supported sources: Web Refer to it as Hotjar in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode	Device Mode Transformations
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record	AudienceList
Device mode
Web

Domain allowlisting for web device mode

In web device mode, RudderStack loads the Hotjar native SDK from https://static.hotjar.com. The script path contains your account ID (Site ID). Depending on your Content Security Policy, allow these sources in script-src.

You can monitor vendor scripts with a report-only Content Security Policy.

Get started

Once you have confirmed that Hotjar supports the source, perform the steps below:

• From your RudderStack dashboard, add the source. Then, select Hotjar from the list of destinations.
• Assign a name to your destination and click Next. You should see the following screen:

Connection settings

To successfully configure Hotjar as a destination in RudderStack, enter the following connection settings:

• Site ID: Enter your Hotjar site ID. You can get your site ID by logging into your Hotjar account and navigating to Settings > Sites & Organizations.

Finally, click Next to complete the configuration. Hotjar will now be added and enabled as a destination in RudderStack.

Track

The track call leverages Hotjar’s Events API to track specific user actions.

A sample track call is as shown below:

rudderanalytics.track("custom_event");

To use the Hotjar Events API, you must be on Hotjar’s Plus, Business, or Scale plans.

Identify

The identify call lets you pass your user data to Hotjar, sending them as User Attributes.

Before you start making identify calls, make sure that User Attributes are enabled in your Hotjar dashboard for each site. Refer to this Hotjar support page for more information on enabling and disabling User Attributes.

A sample identify call is shown below:

rudderanalytics.identify("userId", {
  total_spend: 500
});