Installing your Heatmap snippets is easy and simple. Follow our Installation Guides for step-by-step instructions.
If you're still having issues with Snippet Installation, here are some troubleshooting techniques that may help resolve the issue:
Snippet Troubleshooting Techniques
Heatmap Tracking Code Snippet
Check where the snippet is added
For Shopify: Confirm it's inside the theme.liquid file, within the
<head>section.For 3rd-party builders (ie: Replo, Zipify, GemPages, PageFly, etc.): Confirm it's added in the global head section of the page.
Verify there's only one snippet
Open your site's source and search for "Heatmap"
There should be only one snippet code with the correct Site ID that matches your Heatmap account.
To verify you have the correct snippet code, go to your Heatmap Portal > Settings > Snippet and copy the Tracking Code Snippet (top snippet).
Confirm that the snippet is firing
Open your browser's Network tab and reload the page.
You should see requests to:
preprocessor
heatmap-light
v1
Heatmap Conversion Code Snippet (Revenue Snippet)
Review how the snippet is installed
For Shopify:
Go to your Customer Events page
Compare the revenue snippet code installed with the one listed in your Heatmap account. To verify you have the correct snippet code, go to your Heatmap Portal > Settings > Snippet and copy the Revenue Pixel Snippet (bottom snippet).
Under permissions, set the following options:
Permission: Not required
Data sale: Data collected does not qualify as data sale
Finally, make sure your Heatmap pixel is connected
If it's disconnected, the pixel will appear grayed out instead of highlighted in green.
For WordPress / WooCommerce:
The traffic and revenue snippets are installed through the Heatmap plugin (.zip file).
To confirm installation:
Open Inspect → Elements / Console / Network and check for the same requests listed above (preprocessor, heatmap-light, v1).
Provide our team with a coupon code that includes shipping costs so we can run a test transaction.
The Heatmap team will verify that revenue data flows correctly into your dashboard after the test order.
Still Need Help?
If you're still having issues with your snippet installation after some initial troubleshooting, please don't hesitate to reach out to our support team to further help troubleshoot. You can contact us via chat or by emailing support@heatmap.com.