Installing Gist on your product or website is the most important part of your journey to get started. After following our installation guide, if the Gist Messenger doesn't appear on your site, then this article should help you understand the typical things to look out for.
Usually, these troubleshooting steps will solve any problems with installation, but if your issue remains unaddressed, we recommend you also check if the tracking code is installed correctly.
1. Incorrect Coding
The Gist JavaScript snippet code should be installed directly in your website code, just before the </head> tag. If the snippet is placed elsewhere, it may not load and be timed out.
Also, check for any typos within the snippet code. If you copy-paste the code directly from the documentation on this site, you should be fine. But if you pasted the code from another place (like an email or a word document), it is possible that the code had been reformatted by the word processors.
2. Adding Gist Snippet Twice
You only need to install the Gist JavaScript snippet code once. If you have installed Gist using the WordPress Plugin or Google Tag Manager, you no longer need to install the snippet directly
3. Incorrect Workspace ID
If you copy-paste the code from other documentation or a public forum, you need to ensure that you replace the Workspace ID with your own. We recommend you copy the Gist JavaScript snippet code directly from the Settings page of your workspace.
4. Cloudflare
If you are using Cloudflare, Gist’s snippet code will be run with Rocket Loader, which leads to compression and concatenation of the Javascript code. This prevents the Gist code from loading properly. Ensure you turn rocketscript off for Gist so the code can load and function.
5. Firewalls and Adblockers
Adblocker extensions and plugins can sometimes prevent Gist from loading the JavaScript files needed for it to work.
If Gist isn’t working due to the presence of adblockers, you should see errors in your developer console, like: Failed to load resource: net::ERR_BLOCKED_BY_CLIENT
If this happens, either disable the adblocker extension or ensure that you whitelist *.getgist.com within the extension. Similarly, check your system’s internet firewall and see if it is blocking Gist from interacting with your site.
If you are still unable to make Gist work, let our team know via in-app chat and we will do our best to help you get Gist running for you.
Need Help?
If you have any further questions, please start a Live Chat. Just "Click" on the Chat Icon in the lower right corner to talk with our support team.
