Install on WordPress

Last checked against the product on 1 August 2026

All plans

WordPress powers more websites than any other platform. There are three ways to add your Aijent to one, and we recommend the first.

Whichever you choose, the job is the same: get your install code into the part of your website that loads on every page, called the header. You are not editing your content or your design, and nothing here changes how your site looks.

Before you start

Two things in your dashboard first. This order saves the most common frustration.

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.

Adding yourwebsite.com also covers www.yourwebsite.com. 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 will serve whichever Aijent is currently your main one. If you have added further Aijents, each of those has its own code that names that specific Aijent. Either way, copy it from your own dashboard rather than from anywhere else.

Method 1: with a plugin (recommended)

A header scripts plugin is the safest route. Your code sits outside your theme, so it survives theme updates, and you never edit a theme file. If something goes wrong, deactivate the plugin and you are back where you started.

1. In WordPress, go to Plugins, then Add New Plugin.
2. Search for WPCode. It used to be called Insert Headers and Footers, and you may still see it listed that way.
3. Select Install Now, then Activate.
4. A Code Snippets item appears in the left menu. Go to it, then choose Header & Footer.
5. Paste your install code into the Header box. Not Body, not Footer.
6. Select Save Changes.

Any similar header scripts plugin works the same way. All that matters is that the code ends up in the header.

Method 2: your theme's own settings

Many paid themes include a place for custom code, which avoids adding a plugin.

1. Go to Appearance, then Customise.
2. Look for a section named Custom Code, Header Scripts, Custom Scripts or similar. The name varies by theme.
3. Paste your install code into the header field.
4. Select Publish.

If you cannot find anything like that, your theme does not support it. Use Method 1 rather than forcing it somewhere else.

Method 3: edit the theme directly

Only if you are comfortable editing theme files, only on a child theme, and only on a classic (non-block) theme.

This matters: code added directly to a parent theme is erased the next time that theme updates, and themes update often. Your Aijent would silently vanish weeks later with no obvious cause.

1. Go to Appearance, then Theme File Editor.
2. Open header.php.
3. Paste your install code immediately before the closing </head> tag.
4. Select Update File.

If you are not certain you are on a child theme, use Method 1.

Check it worked

Open your website in a brand new private or incognito window.

This is not fussiness. WordPress sites are almost always cached, meaning saved copies of your pages are served for speed. The tab you have been working in will often keep showing the old version, which 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.

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, no matter how 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. Clear it if you did not mean to restrict it.

Are you looking at a cached page? If you use a caching plugin such as WP Rocket, W3 Total Cache or LiteSpeed Cache, clear its cache. If your site sits behind Cloudflare or similar, purge that too. 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.

Is a security or optimisation plugin stripping it? Some plugins that combine or minify scripts remove code they do not recognise. Try excluding the Aijency script, or switch that plugin off briefly to see whether your Aijent appears.

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

Still stuck? Contact us with your website address and the method you used, and we will look at it directly.

Putting your Aijent inside a page

Growth, Pro and Aijent Relay only

Instead of waiting in the corner, your Aijent can sit inside a page, already open, as part of the content. It works well on landing pages. See in-page placement for what it is and how it behaves.

1. Edit the page where you want your Aijent.
2. Add a Custom HTML block where you want it to appear.
3. Paste the in-page code into that block.
4. Update the page.

On the classic editor, switch to the Text tab rather than Visual, and paste it there. Pasting into the Visual tab will mangle it.

Then open the page in a fresh private window and check three things: your Aijent appears where you put it, the launcher is gone on that page, and the launcher is still there on your other pages.

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. A sales Aijent on your pricing pages and a support Aijent on your help pages works well.

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