---
title: Contentsquare (Hotjar)
slug: contentsquare-hotjar
createdAt: 2025-12-01T23:44:04.429Z
---

## Introduction

Hotjar is a behavior analytics and feedback tool that helps you understand how users interact with your site through heatmaps, session recordings, and on-site surveys. By tracking user sessions and interactions, Hotjar gives product, UX, and marketing teams a clearer picture of what’s working—and what needs improvement—across the customer journey.

## Getting started

This is a **device-mode** destination, which means Chord helps you send events directly from your site to Hotjar.

To connect Hotjar as a CDP destination, you’ll need your Hotjar Site ID. You can find this in your Hotjar account under **Settings → Sites & Organizations → Tracking code**. The Site ID is the numeric value associated with your site (often shown in or alongside the tracking code, such as the number after `hjid=`). 

Make sure you have:

- An active Hotjar account and site set up 
- Permissions to access the Site ID 
- Any internal approvals required to add or modify tracking on your site 

## Connecting to the Contentsquare (Hotjar) CDP destination

:::hint{type="danger"}
Before connecting destinations in the Chord CDP, please verify with all Destination owners that all **non-Chord CDP** configured destinations are *disabled.*
**
Running external destinations alongside configured Chord CDP destinations ***can result in duplicate events downstream. ***
:::

1. Log into the **Chord Data Platform**. 
2. Navigate to the **CDP**. 
3. Click the **“Add”** button next to **Destinations**. 
4. Select **Contentsquare (Hotjar)** from the destination catalog. 
5. Enter a **Destination name** that your team will recognize (e.g., “Hotjar – Production”). 
6. Enter your **Contentsquare Site ID**. 
7. Click **“Create”** to connect the destination. 

Once connected, Chord will begin sending the relevant events to Hotjar based on your CDP configuration and tracking setup.

## Avoiding duplicate tracking

Before connecting destinations in the Chord CDP, please verify with all destination owners that any **non–Chord CDP–configured Contentsquare (Hotjar) tracking** (for example, legacy tags installed directly on your site, in your tag manager, or via another platform) is disabled or removed where appropriate.

Running external Hotjar tags alongside the configured Chord CDP destination can result in:

- **Duplicate pageview/session data** in Hotjar 
- Inflated heatmaps and session recordings 
- Confusing or misleading analytics for product and UX teams 

If you’re unsure whether legacy Hotjar tracking is still installed, coordinate with your engineering or analytics team to review existing tags and scripts before enabling the destination.

# Events

This destination does not forward individual page, track, or identify events. The Contentsquare SDK is loaded on the first event received from any type, and from that point the SDK handles all behavior tracking autonomously via the `window._uxa` global.

## Initialization

The plugin loads the SDK on the first event it receives, regardless of event type. Unlike other destinations, it does not queue or process subsequent events — its sole purpose is to ensure the Contentsquare script is loaded once.

The plugin manages SDK loading state (`fresh` → `loading` → `loaded`/`failed`) to prevent duplicate script loads. If the script fails to load, a warning is logged and no further load attempts are made.

## CSP requirements

If your site uses a Content Security Policy, allow the following domains:

| Directive     | Domain                        |
| ------------- | ----------------------------- |
| `script-src`  | `https://t.contentsquare.net` |
| `connect-src` | `https://t.contentsquare.net` |