Any other website
How to add your Aijent to any website platform that does not have its own guide.
Almost every website platform works the same way: add your website on the Installation tab, copy your install code, then paste it into a custom code, HTML or header section in your platform's settings so it loads on every page. If your platform has no such option, use Google Tag Manager, which works on any site.
Almost every platform works the same way, and this covers the ones without their own guide.
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.
- Open your Aijent from the Aijents section.
- Go to the Installation tab.
- Under Step 1, Choose where your Aijent can appear, select Add website.
- 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.
The universal method
Your Aijent is a single piece of code that needs to load on every page. Nearly every website platform has somewhere to put it. Look in your platform's settings for anything called:
- Custom code, Custom HTML or Code injection
- Header or Head, sometimes described as "before the closing head tag"
- Site-wide scripts, Tracking code or Third-party scripts
Paste your install code there, choose the option that applies it to all pages, save, and publish.
If you edit your own HTML
Paste the code immediately before the closing </head> tag on every page. If your
site uses a shared header or layout file, put it there once instead.
If nothing like that exists
Use Google Tag Manager. It works on any website and does not require your platform to support custom code.
Notes for less common platforms
- Magento and Adobe Commerce: Content, then Design, then Configuration. Edit the row for your store view, then use Scripts and Style Sheets in the HTML Head section. If your store runs a strict content security policy, the script may also need allowlisting.
- Ghost: Settings, then Advanced, then Code injection, then Site header.
- Craft CMS and other developer platforms: add it to your base layout
template, before
</head>. - ClickFunnels, Kajabi, Leadpages and Unbounce: each has a per-page or per-funnel tracking code or head section. Use the site-wide option if there is one, otherwise add it to each page you want your Aijent on.
- Carrd and other single-page builders: these usually need a paid plan before custom code is available.
- Headless or custom-built sites: give the code to your developer and ask for it in the shared page head.
If your platform is not here and you cannot find where the code goes, get in touch and tell us what you use. We will find it for you, and add a guide.
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 onlyInstead of waiting in the corner, your Aijent can sit inside a page, already open. See in-page placement for what it is.
This is a different code from the one above
The in-page code is not your normal install code. Copy it from the In-page Aijent tab, after turning on Show this Aijent inside a page.
The method is the same everywhere. Add one of these where you want your Aijent to appear, and paste the in-page code into it:
- Custom HTML, HTML or Embed block
- Code block or Code injection
- Custom code section
If you edit your own HTML, paste it exactly where you want it in the page body.
If your editor strips it, look for a dedicated code or embed block rather than pasting into a rich-text field. Rich-text editors commonly remove code they do not recognise.
Then open the page in a fresh private window and check your Aijent appears where you put it, and that the launcher is gone on that page but still on the others.
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.