Following the tips below should help Hotjar work with many types of privately accessible websites, but because Hotjar is only able to support websites that are publicly accessible, we can’t guarantee this will solve every issue.
Tips for using Hotjar on Staging Servers and Localhost
In order to have Hotjar run correctly on your Staging/Testing Server or Intranet, we suggest that:
- Your site can be connected to from our servers. Having your site publicly available and not behind a firewall is best, however, if it isn’t, Hotjar’s IP addresses must be whitelisted and have access to collect assets (like images, fonts and CSS files) from the site.
- Your site needs to use valid HTTPS certificates if it uses HTTPS. We cannot guarantee self-certifications will allow our tracking code to work correctly.
- The computer you are using to view your data also needs to have access to your site. All elements, such as CSS, will need to be accessible to the person viewing the Recording to show correctly.
Exceptions to take into consideration
- Our Forms feature currently loads the page you enter in a headless browser which parses the HTML to detect Forms. If the page is not publicly available, Hotjar wouldn't be able to access the HTML of that page and in turn, will not find any Forms.
- Heatmaps and Incoming Feedback rely on the images and CSS files being publicly available, while HTML is collected and sent back to Hotjar directly from the visitor's device. When we take the screenshot for your Heatmap or Incoming Feedback screenshot, CSS and image files are loaded directly from your server.
- When we collect a Recording, we attempt to store the CSS files on our side if they are accessible. If they are not accessible, we will attempt to load them directly from your server. This does mean that it is possible to view Recordings if the local device has access to these assets. For example, if your assets are available locally at my-intranet.local, and you are using a device that is connected to your Intranet, you will be able to playback a Recording without issue.