This feature is only available on the Plus and Business plan.
JavaScript will need to be added to your site's source code or through Google Tag manager by your web development team.
Using JavaScript to trigger a Feedback widget can be used where Hotjar's targeting rules are not enough to target a specific audience.
These triggers could be used if:
- You want a Poll to appear only after your visitor has reached a specific part of the page.
- You want the Survey pop-up to appear as soon as your visitors clicks on a specific element.
This feature is also available for Recordings and Heatmaps.
Using Triggers with Hotjar installed via GTM
If you are using GTM along with Hotjar's JavaScript tagging, triggers, virtual page views, or stateChange for single page apps, you should avoid using the workaround script listed in the documentation to queue tags or triggers until the Hotjar script loads.
If you plan on using any of these functions heavily, we recommend installing Hotjar through GTM manually as a custom tag.
Select JavaScript trigger from your page targeting panel.
Enter a name you would like to use as your trigger.
You can select the '+' icon if you would like to add another targeting rule. Only alphanumeric characters, dashes and underscores can be used in the trigger name.
Triggers will show before other targeting rules
If a trigger is present on a page, it will cause a the Poll, Survey, Incoming Feedback or Recruiter, to show regardless of any other rules present.
Click Done.
Add the trigger code to your website.
In the example above, you've created a trigger called mypoll. Next, you will need to add the trigger code to your website:
hj('trigger', 'mypoll');
If this script is added before the Tracking Code, there will be an error
This code must be added at any point after the Hotjar Tracking Code.
Advanced JavaScript Trigger Settings
This code is for advanced users
If you'd like to implement any of this code, we'd suggest reaching out to your web development team to make sure installation is correct.
Trigger for When the User Completed a Specific Action
In this scenario, you would add this line of code to one of your JavaScript functions:
function newsletterSignup() {
...
hj('trigger', 'signup-poll');
}
When using triggers for widgets, your behavior rules will still be followed. As an example, if you set a poll to open after 10 seconds and then use a JavaScript trigger, the poll will appear 10 seconds after triggering it with the code above.
Trigger for if the Code Will Run Before the Hotjar Script is Loaded
In this scenario, you would need to add this line of code:
window.hj=window.hj||function(){(hj.q=hj.q||[]).push(arguments)};