Available for Ask with the
,
or
plans. See the Hotjar pricing page for plans and pricing.
With Hotjar Events, you can send events to Hotjar based on actions or changes happening on your site such as scrolling to a specific part of the page or clicking a button. This article steps through how these events can be used in Hotjar to trigger Surveys and Feedback widgets to appear.
For more detail on Events and how they work, see our article on What are Events?
Using Events for Survey and Feedback widget targeting can be useful when Hotjar's URL targeting rules are not enough. Keep in mind that Event-based targeting will override all URL-based targeting, including Excluded URL targets.
The Hotjar Events feature needs to be set up on your site and sending events before you follow this guide
If your site isn't sending events to Hotjar using the Hotjar Events API, you'll need to get that set up first. See our How to Set Up Events or How to Send Events With Google Tag Manager articles to learn how.
Follow the steps to create a survey or feedback widget until you get to the Targeting section.
See our How to Set Up Surveys article for help creating a Survey.
For help creating a Feedback widget, see our How to Set Up Feedback article.
In the Targeting section, select Specific pages and choose Event from the dropdown menu.
Enter the event name in the Event field.
This is the name of the event that, when triggered on your site, will make the Survey or Feedback widget appear.
Click on Add another if you would like to add another targeting rule. Only alphanumeric characters (a-z, A-Z, 0-9), underscores (_), and dashes (-) can be used in the event name.
Events take priority over other targeting options such as URLs
If the targeted event is present on a page, it will take priority over other targeting rules present, including URL targeting rules. As events take priority, it will cause the Survey or Feedback widget to show regardless of any other rules present.
Finish creating the survey or feedback widget and set its status to Active.
Your Survey or Feedback widget will appear when the event you've specified is present on a page.
When using events for Surveys, your behavior rules will still be followed. For example, you can set a survey to open after 10 seconds and use an event for targeting. In this case, the survey will appear 10 seconds after the event has been triggered (not 10 seconds after the page loaded).
Trigger on page events, not state changes
Hotjar Events were designed to allow Surveys and Feedback widgets to appear based on events that occur on a webpage. Targeting Hotjar Events based on state changes rather than events on the page can cause inconsistent performance and is not advised.