Why Do Pages Look Broken or Have No CSS Loading in Heatmap?

If you've noticed that your pages appear broken or are missing CSS styling when viewed in Heatmap, don't worry. This is a common issue that can usually be resolved quickly. This article will explain why this happens and how to fix it.

Why Does This Happen?

Heatmap needs to access your website's assets, including CSS files, to generate accurate heatmaps and recordings. When pages look broken or CSS isn't loading properly, it typically means our servers are having trouble fetching some of the CSS files from your server.

Common Causes:

1. Geolocation restrictions: Your site may only allow access from specific geographic locations.

2. IP restrictions: Your server may only allow specific IP addresses to access assets.

3. Domain/referrer blocking: Your site may block requests from unknown domains or referrers.

4. Cookie/session storage restrictions: Your site may require cookies or session storage to serve assets.

How to Fix It:

To resolve this issue, you'll need to allow Heatmap's servers to access your CSS files. Here are the steps to take:

1. Whitelist Heatmap IP Addresses:

- Contact Heatmap support to obtain the list of IP addresses used by our servers.

- Add these IP addresses to your server's whitelist or firewall rules.

2. Allow Heatmap Domain/Referrer:

- Add the Heatmap domain (provided by support) to your list of allowed domains or referrers.

3. Review Cookie and Session Policies:

- If your site requires cookies or session storage to serve assets, you may need to adjust these settings to allow Heatmap access.

4. Check Geolocation Restrictions:

- Ensure that your geolocation restrictions aren't blocking Heatmap's servers.

After making these changes, refresh your Heatmap dashboard and check if the issue is resolved. If you're still experiencing problems, please contact our support team for further assistance.

Note: Always ensure that allowing access for Heatmap doesn't compromise your site's overall security. If you have any concerns, consult with your IT security team before making changes.

By following these steps, you should be able to resolve issues with broken pages or missing CSS in Heatmap, allowing you to get the most accurate and useful data from our tools.

If you need any additional help or have questions, please don't hesitate to reach out to our support team.