Install on Google Tag Manager

Last checked against the product on 1 August 2026

All plans

If you already use Tag Manager, this works on any website without touching your site's code.

Before you start

Two things in your dashboard first. This order matters, and doing it the other way round is the single most common reason an Aijent does not appear.

1. Add your website

Your Aijent only runs on websites you have added. This stops anyone who gets hold of your install code from putting your Aijent, and your conversation allowance, on a website you do not own.

1. Open your Aijent from the Aijents section.
2. Go to the Installation tab.
3. Under Step 1, Choose where your Aijent can appear, select Add website.
4. Enter your website address. It is added immediately, with no separate save.

Adding yourwebsite.com also covers www.yourwebsite.com, and you cannot add both. Other subdomains, such as shop.yourwebsite.com or a staging address, are separate websites and need adding separately.

2. Copy your install code

On the same Installation tab, under Step 2, Install your Aijent, select Copy. Use the button rather than highlighting the text by hand, so you get all of it.

If this is your main Aijent, the code identifies your account and serves whichever Aijent is currently your main one. Additional Aijents each have their own code that names that specific Aijent.

Add the code to Google Tag Manager

1. In Google Tag Manager, open your container and go to Tags, then New.
2. Name it something like "Aijent".
3. For Tag Configuration, choose Custom HTML.
4. Paste your install code into the HTML box.
5. For Triggering, choose All Pages.
6. Save, then Submit and publish the container.

One caution: Tag Manager loads your Aijent slightly later than putting the code in your site's header, so it may take an extra moment to appear. If you can add the code directly to your site instead, that is marginally better.

Check it worked

Open your website in a brand new private or incognito window. Not the tab you have been working in.

This is not fussiness. Most websites are cached, meaning saved copies of your pages are served for speed, so the tab you have been working in will often keep showing the version from before you added the code. That makes a perfectly good installation look like a failure.

Your Aijent should appear within a few seconds. Say hello to it.

If it does not appear

Work through these in order. The first two account for most cases.

Is your Aijent switched on? On the Config tab there is an Agent Status control set to either LIVE or OFF. If it is OFF, your Aijent appears nowhere, however correctly the code is installed. Switching it back to LIVE takes effect immediately, with no save step. (Aijent Relay has no on or off control, so this does not apply to Relay.)

Is the website on your list? Check it appears under Step 1 on the Installation tab, and that the address matches the site you are actually looking at. A staging or preview address is a separate website and needs adding separately.

Have you restricted it to certain pages? Step 1 has an Only show on these pages field for each website. If anything is in it, your Aijent appears on those pages and nowhere else.

Are you looking at a cached page? Clear any caching your site uses, and purge your CDN if you have one, then open a fresh incognito window.

Did the whole code paste? Compare what you saved against the Installation tab. Some editors quietly trim the closing tag, which breaks it.

Have you placed an in-page Aijent on that page? If your Aijent is embedded directly into that page's content, the floating launcher is hidden there by design. That is a working installation, not a fault.

Still stuck? Get in touch with your website address and the steps you followed, and we will look at it directly.

Putting your Aijent inside a page

Growth, Pro and Aijent Relay only

Tag Manager is the wrong tool for this one.

In-page placement needs the code to sit in a specific spot in your page, because where you paste it is where your Aijent appears. Tag Manager injects code into the page rather than placing it somewhere particular, so it cannot control position.

Add the in-page code directly to the page instead, using your platform's HTML or embed block. Every platform guide has the exact steps at the bottom.

Tag Manager remains a good option for the normal corner launcher, which is what this page covers.

Running more than one Aijent

Only one Aijent can appear on a given page. If two install codes end up on the same page, the second is ignored, and which one wins depends on the order they load, so the result is unpredictable rather than doubled.

Give each Aijent its own pages instead.

Running more than one Aijent is available on Growth and Pro. You can see your current plan and change it on your billing page.