Back to Installation Guides

Add heatmapp to your React application

Follow these steps to integrate heatmapp analytics into your React application.

Add tracking script to your React app

Add the tracking script to your React application in your main App.js or public/index.html:


Method 1: In public/index.html (Recommended)

1. Open your `public/index.html` file

2. Add the script to the `<head>` section:

Code
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>React App</title>
    
    <!-- Add heatmapp tracking script -->
    <script
      defer
      data-website-id="YOUR_WEBSITE_ID"
      data-domain="your_domain.com"
      src="https://heatm.app/js/script.v2.min.js"
    ></script>
  </head>
  <body>
    <div id="root"></div>
  </body>
</html>
!

Replace `YOUR_WEBSITE_ID` with your actual Website ID from heatmapp. Replace `your_domain.com` with your website's root domain.

Verify installation

After implementing:


  • Visit your live website
  • Check your heatmapp dashboard for incoming data
  • It might take a few minutes for the first pageviews to appear

For advanced configuration options like localhost tracking, custom API endpoints, or cross-domain setup, see the script configuration reference.