Installing the Javascript

Installing the Qualified javascript snippet on your marketing website is required for the system to function. In this article, we'll cover:

  1. An overview of the Qualified javascript snippet
  2. Pages you need to place the snippet on
  3. How to install the snippet
  4. How to test successful installation

1) An Overview of the Qualified Javascript Snippet

The javascript snippet is a small piece of code that, once installed on your site, will be able to recognize visitors and communicate to the Qualified application to take appropriate actions. When you initially add Qualified JS to your site, you will notice no visible change (ie nothing will appear on your website). The Qualified messenger will not appear, a chatbot will not appear, in fact, nothing will appear to be different until you create and activate your experiences.

To find the javascript snippet for your organization Settings > Messenger settings.

It's important to note that each javascript snippet has a token that is unique to your account .The javascript snippet looks like this:

The Qualified javascript snippet (sample)

2) Pages to Place the Snippet On

The javascript snippet must be placed on every page on your marketing site that you wish to track leads and have conversations. Many companies have a team of web developers who have access to the website infrastructure, and only these folks are allowed to add the javascript. It's important to note here that accurate instructions must be given to install the snippet on all marketing web properties to make sure the system is functioning properly. Consider the following pages on your website which may be running on different platforms or CMS systems:

  • Marketing website (usually www.company.com)
  • Marketing landing pages (might be running on a landing page service)
  • Blogs (which usually run on a separate CMS system)
  • Any other web pages served by another app (eg, Marketing Automation)
Place the javascript snippet on all of your marketing pages
Place the javascript snippet on all of your marketing pages

3) How To Install the Javascript

For the system to function properly, it's important to place the javascript snippet on all of your marketing pages, just before the end of the </head> section of your website. You can either add this manually to your website, or if you are using a hosting system or other CMS, there is commonly an area where you can paste this into your <head> section.

Please note that placing the Javascript within Google Tag Manager can cause Qualified to be blocked by some third party ad blockers. We recommend considering not putting mission-critical apps in your tag management system but rather placing them directly into your website. The downside to this action is that depending on the app or script in question, it might still get blocked.

4) How to Test Successful Installation

You'll know the installation is successful by signing into the Qualified application to see your live website traffic. It's a good idea to do a quick test by opening an incognito window and testing all of the sections on your website, including your main marketing site. landing pages, blog pages, and pages served by other apps, such as content pages. You'll see the visitors on your site on the main map, as seen below.

Confirming the javascript is successfully installed on your site

Website Performance

The Qualified JS is a 76 kb snippet that fires asynchronously on your website after first contentful paint, so there will be no (or technically a negligible) performance impact to site load time.

The remainder of the loading sequence also happens asynchronously to serve the personalized experience.


In this guide, you've received an overview of the Qualified javascript snippet and instructions on how to install the snippet on your site.

Request a live demo

See Qualified in action on your website. Request a live demo and one of our reps will contact you immediately, or talk to us right now.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Free custom demo
Live on your site