Check your Wordpress version!
The official Hotjar plugin is only compatible with Wordpress 4.6 or higher. Using the plugin on lower versions will break your site! You can still use Hotjar, but you should instead add the Hotjar Tracking Code to your header.
The Hotjar Tracking Code can be installed on Wordpress.com Business plan and self-hosted versions of Wordpress (from Wordpress.org). You don't need to use the paid version of Hotjar to install the plugin.
Unfortunately, Hotjar isn't available for users on a Wordpress.com free or personal plan since you cannot add Custom HTML or install plugins on these plans.
Installing Hotjar with WordPress Plugin
Check your Wordpress version!
The official Hotjar plugin is only compatible with Wordpress 4.6 or higher. Using the plugin on lower versions will break your site! You can still use Hotjar, but you should instead add the Hotjar Tracking Code to your header.
Step-by-Step Guide: WordPress Plugin
Select Add New within your Wordpress Plugin menu.
This can be found on the left-hand side of the WordPress dashboard.
Install the official Hotjar Plugin.
By searching for "Hotjar", you should find the official Hotjar Plugin in the results:
Navigate to the Hotjar Plugin within WordPress
After installing the Hotjar Plugin, navigate to "Settings" from your panel on the left-hand side and click on Hotjar from the dropdown.
Find your Hotjar Site ID.
You can find your Hotjar Site ID once you've clicked on Hotjar Site list (or this link).
Copy the Site ID for the site you wish to install the Tracking Code for. The Site ID is the set of numbers next to the Site URL.
Paste your Hotjar ID within Wordpress.
Go back to your Hotjar Settings in WordPress and add the Site ID into the field Hotjar ID.
Click Save Changes
Verify installation
Once you've saved your changes, you’ll get a notification at the top letting you know that the script was installed. Select “Click here to verify your install” to make sure you’ve installed the Tracking Code properly. A new tab will open up showing you your website with a notification that reads “Hotjar installation verified”.
Remember to backup your WordPress installation before installing any new plugins to your site.
Double-check your Tracking Code installation after making design changes
If your website undergoes a major design change after you install the Tracking Code, check to ensure your Tracking Code is still installed. Design changes may cause the Tracking Code to be removed, which will prevent Hotjar from collecting data.
Still having trouble installing the code?
If your WordPress blog uses any caching plugins, you may have to clear your cache to make sure the script is added to your site.
It is also important to wait a few minutes for Hotjar to check if it is installed correctly once the Tracking Code is installed. This usually happens the moment your site is loaded with the Hotjar Tracking Code on it (you can visit the page yourself to speed it up).
You can verify the installation manually by following these steps or reach out to our Support team below so we can help you!
Once Your Tracking Code is Installed
You can start using any of Hotjar's features: Heatmaps, Recordings, Surveys, and Incoming Feedback. Have a look at the guides below to get started.
- Creating Your First Heatmap with Snapshots
- How to Start Continuous Heatmaps
- How to Start Recordings on Basic Plans
- How to Start Continuous Recordings
- Creating Your First Survey
- Starting to use Incoming Feedback
Next Steps
- Add team members to your organization.
- Add sites to your organization.
- Understand the difference between Accounts, Organizations, and Sites.
- Use Hotjar for your clients.