Observe Observe plan. Book a call with our Sales team, to learn more about Scale plan features.
All Sites initially have console tracking turned off by default. After a team member with Admin permissions has turned on console tracking in your Site settings, future sessions will begin capturing console logs.
This article will cover the following:
- How to turn console tracking on and off
- How to view errors in the Recordings player console
- How to apply the Error filter to your Recordings list
- What types of errors are captured
- FAQs for console tracking
Recordings data cannot be exported when an Error filter is applied
When an Error filter is applied to your Recordings Playback List, it's currently not possible to export this data. If you try to export Recordings data with the filter applied, you'll see the following message: Something went wrong. Please adjust your filters and retry.
How to turn console tracking on or off
Admin permissions are required to make changes to console tracking
You'll need to have Admin permission levels to turn console tracking on or off in your site settings. You can check which team members have the required Admin permission level by visiting your Team page.
Visit your Sites & Organizations page.
Click the site settings gear icon to visit your site settings page.
Click the Session targeting & tracking section on your site settings page.
How to view errors in the Recordings player console
Visit your Recordings page.
Click Play on any recording in the playback list.
Inside the Recordings player, click the Open console icon to show the Recordings console.
In the Session Info tab, you can see if any console errors occurred in the current recording and the number of errors. You'll also be able to view these in the Recordings console above the playback timeline.
When you come across a console error on a recording playback, you can also view a trend or recordings of the same error occurring by clicking on the error icon in the playback toolbar and selecting View trend or the recordings play icon.
When console tracking is turned off, you'll see the message shown below asking you to activate console tracking. If you have Admin permission levels, clicking Switch on console tracking will turn console tracking on. To turn it off again, follow the steps in the How to turn console tracking on or off section above.
How to apply the Error filter to your Recordings list
What types of errors are captured
Hotjar currently captures uncaught errors. These are errors that are not being handled by your site in any way. "Handling" an error means that your site sees the error, and takes action to prevent it from affecting the user's experience.
Hotjar currently uses an
EvenListener to capture the following uncaught events:
This happens when there's been an error loading an external file or using a resource, such as an image, or if a script has an execution error.
Each error is an object based upon the
Error object, and has a
name and a
Some examples are:
- Error: Permission denied to access property "x" - occurs when there was an attempt to access an object for which you have no permission.
- SyntaxError: illegal character - occurs when there is an invalid or unexpected token that doesn't belong at this position in the code.
- TypeError: "x" is not a function - occurs when there was an attempt to call a value from a function, but the value is not actually a function.
- Script error (a generic error, showing only a timestamp) - these errors are thrown by cross-origin scripts that the browser prevents capturing.
Your developer team will be able to set the rejection event message that appears in the Developer Console, but it may look something like:
- Uncaught (in promise) something went wrong
FAQs for console tracking
What happens to console tracking if I downgrade my plan?
When downgrading to a plan that doesn't support console tracking, error capturing will no longer work and no console information will be recorded. The console tracking option will be greyed out in your site settings, and the related checkbox will remain 'checked' or 'unchecked' based on what was configured at the time of the downgrade.
If you upgrade your Hotjar Site to an Observe BusinessObserve Scale plan in the future, the console tracking feature will resume based on your previously saved configurations. Console tracking will not work unless the Site is on an Observe BusinessObserve Scale plan, regardless of the greyed out configurations. Errors that occur while the site is on a different plan will not be recorded even if the checkbox is 'checked'.
Can I see an overview of all the errors occurring on my site?
There is not a complete list of all errors, but your Dashboards have a section where you can view the Top console errors occurring in your session data. This information is visible in bar/pie chart or line graph form.