Google Tag Manager should be installed before you follow this guide
If you don't have Google Tag Manager installed yet you can find out how in the Google Tag Manager support article about installing it.
If you are using GTM to load Hotjar on your page, and you're trying to use recording tags, Javascript triggers, virtual page views, or stateChange, you should avoid using the Hotjar Tracking Code tag type to load Hotjar in GTM. The reason for this is that there is a current limitation with that integration and it causes all of these Javascript features to fail.
If you plan on using any of these functions, we recommend installing Hotjar through GTM manually as a Custom HTML tag.
Click Add a new tag.
Click the tag icon & select Hotjar Tracking Code from the list.
Enter your Hotjar Site ID into the text field.
To get your Hotjar Site ID, look at the URL of your browser while you're logged into Hotjar: http://insights.hotjar.com/sites/**[SITE_ID]**/dashboard.
You can also navigate to your Sites & Organizations list from the Settings menu. From here you will see a listing of the Sites and Organizations you have access to, along with their IDs.
Set up a trigger to control Hotjar.
Once you click in the Triggering area, you can choose what pages the Tracking Code will appear on.
Select All Pages for the trigger.
Single Page Applications should only use the "Page View" trigger type
Google Tag Manager's state change triggers conflict with Hotjar's own system for detecting changes in single page applications. For more information, take a look at the Google Tag Manager article about the Page View trigger.
Save your workspace.
Click the Submit button on the upper right-hand side of the page.
Click on the Publish button to publish the tag.
Verify your installation within Hotjar.
Keep the Tracking Code in mind when making design changes
If after you install the Tracking Code, your website undergoes a major design change check to ensure your Tracking Code is still installed.
Having trouble installing Hotjar with Google Tag Manager?
You can go through our Troubleshooting Guide or reach out to our support team so we can help you!
Once Your Tracking Code is Installed
You can start using any of Hotjar's 8 features: Heatmaps, Recordings, Forms, Funnels, Polls, Surveys, Recruiters and Incoming Feedback. Have a look at the guides below to get started.
- Creating Your First Heatmap Report
- How to Start Recordings
- Creating Your First Form Report
- Creating Your First Funnel Report
- Creating Your First Poll
- Creating Your First Survey
- Creating Your First Recruiters Widget
- Starting to use Incoming Feedback
Next Steps
- Add users to your organization.
- Add sites to your organization.
- Understand the difference between Accounts, Organizations, and Sites.
- Use Hotjar for your clients.