Help Center

Top article results

    Set up Hotjar analytics

    Set up Hotjar analytics

    Photo of Brienne Wong

    Brienne Wong

    This feature is available on all Enterprise plans. Want this and other premium features? Update your plan here.

    We recommend that you close all browser windows before you begin, then log in to Hotjar and zeroheight in a standard browser window. If you use SSO protection on your styleguide you will need help from someone who has SSO access to the styleguide but is not an editor on the team.

    1) In your Hotjar account, add a new site:

    Add new site window in Hotjar

    2) In zeroheight, open the styleguide you want to track and click on the Share button. Copy the link.

    Share window in zeroheight to get styleguide URL

    3) Paste the link into Hotjar as the new site.

    New site window to paste styleguide URL in

    4) Choose to install the code manually.

    Hotjar window to add code manually

    5) Copy the Site ID in the bottom right corner.

    Hotjar window to grab Site ID

    6) In zeroheight, navigate to styleguide settings and choose the Analytics tab.

    7) Paste the Site ID that you just copied into the Hotjar section:

    Analytics section in the Styleguide Settings to paste Site ID

    8) Click Save in zeroheight.

    9) In Hotjar click Verify installation. Hotjar will open a new browser window and attempt to verify the installation.

    👉 Note: Hotjar will not be able to verify the installation at this stage. This is expected because the integration only tracks viewers of the styleguide and you are an editor.

    10) Copy the styleguide share link again (see step 2). Then:

    • If you have a public or password-protected styleguide go to step 11.
    • If you have an SSO-protected styleguide go to step 12.
    Verify installation page in Hotjar

    11) If you have a public or password-protected styleguide, the next steps are:

    • Open the link in a different browser (e.g. if you use Chrome, open the link in Safari).
    • Interact with the styleguide for around 30-60 seconds.

    12) If you have an SSO-protected styleguide, the next steps are:

    • Send the link to a viewer of the styleguide. This should be someone who has SSO access to the styleguide but is not an editor.
    • Ask them to interact with the styleguide for around 30-60 seconds.

    13) Click Verify installation and you should see that the installation is successfully verified in Hotjar.

    14) You can now continue setting up the Analytics and Feedback tools!