Getting Started

SimpleHeatmaps is a behavioral analytics platform that generates heatmaps based on how people are interacting with your website. By learning how to read these heatmaps you can glean insights on your users' behavior and potential issues with the UI/UX of your product. Moreover, use SimpleHeatmaps powerful data management to see how these heatmaps are changing over time.

Software Requirements

SimpleHeatmaps runs on most modern web browsers. We recommend the most recent versions of the following browsers:


Go to platform specific installation instructions.

Before you can start using SimpleHeatmaps you'll need to configure your website to load the SimpleHeatmaps JavaScript library. The SimpleHeatmaps library is small at 12kb and loads asynchronously so it doesn't have an impact on site load times or performance.

When you first create your SimpleHeatmaps account you'll be presented with a wizard that's designed to help you get set up quickly. Once you see it, click "Get Started" to go to step 1.

The first step of the wizard asks you for the domain URL of the website you want to configure for use with SimpleHeatmaps. While the system tries to handle, clean, and process any format for the URL, we recommend that you enter in the domain URL with the leading "http://" or "https://" prefix. Any path will be automatically removed.

If your website requires SSL (for example, if you redirect http:// to https://) please enable the relevant option on this step titled "Website requires ssl (https)" so that the SimpleHeatmaps platform can reach and take screenshots of your website.

By default, whenever new heatmaps are generated and data has been processed, we'll send out an email (at most once a day) to let you know. If you'd prefer to not get these emails, you can disable them here, or later under website settings.

The second and final step to getting SimpleHeatmaps set up requires you to add our JavaScript library to load on your website. How you do this can depend on that platform and tools used to build and deploy your website. In general, you'll need to copy and paste the highlighted code snippet right before the closing tag on any pages of your website you want to use with SimpleHeatmaps. If you have a layout and/or template that the website uses you should copy and paste the code snippet in there.

How Heatmaps Can Help

Heatmaps expose the behavioral data collected on your website visually. By learning to read heatmaps correctly you can glean insights into how users are (or aren't) expecting to use your website. By tracking how heatmaps change along with design changes on your website, you can use data to determine if your efforts are making a positive or negative impact to the user experience.

What SimpleHeatmaps Does

Once SimpleHeatmaps is up and running, the system automatically starts collecting data points from any pages our JavaScript library loads on. Once enough data points are collected for a page the platform generates a screenshot of the page on various device types (desktop, mobile, etc) and makes the heatmap available for view.

The Table Of Contents