Valiton. ← Back to valiton.org

Installing your assistant

One line of code, pasted once

About three minutes

Contents

contents

  1. The line you’ll paste
  2. WordPress
  3. Squarespace
  4. Wix
  5. A hand-built site
  6. If it isn’t working

The line you’ll paste

Your website already has a box built for exactly this — the same one that holds Google Analytics or a Facebook pixel. You’re adding one line to it. Nothing else on your site changes, and removing the line puts everything back.

Your welcome email has this line with your business’s ID already filled in. Copy it from there, or from here, replacing your-business with the ID in your email.

your script tag 
<script src="https://bot.valiton.org/widget.js" data-client="your-business" async></script>

What this does to your website

It adds a small chat button in the bottom-right corner. It does not change your design, your fonts, your colours, or your layout — the assistant is sealed off from the rest of the page, so your styles can’t leak into it and its styles can’t leak into yours. It’s about 12 KB, roughly a small photo, and it loads after your page has already appeared, so it can’t slow your site down.

If anything below feels wrong, stop and email me. I’ll do it for you at no charge.

WordPress

yoursite.com/wp-admin→Plugins→Add New→“WPCode”→Code Snippets

What you’re looking for

A free plugin called WPCode. WordPress has a built-in code editor too, but don’t use it — a theme update will wipe what you paste there, and your assistant will vanish weeks later with no obvious cause. WPCode survives updates. Search “WPCode” in Plugins → Add New; it’s the one with millions of installs.

  1. Log in at yoursite.com/wp-admin.
  2. In the left sidebar, go to Plugins → Add New. Search WPCode, then click Install Now and Activate.
  3. A new Code Snippets item appears in the left sidebar. Click it, then + Add Snippet.
  4. Choose Add Your Custom Code (New Snippet).
  5. Name it Valiton assistant. Set Code Type to HTML Snippet.
  6. Paste your line into the big code box.
  7. Scroll to Insertion. Choose Auto Insert, and set the location to Site Wide Footer.
  8. At the top right, flip the toggle from Inactive to Active, then click Save Snippet.

Check it worked

Open your website in a new tab — your real address, not the WordPress editor. The chat button appears in the bottom-right within a second or two. Click it and ask something you know your site answers.

It went in the header instead of the footer

Symptom: nothing appears, or your site loads noticeably slower.

WPCode’s Insertion menu offers Site Wide Header and Site Wide Footer. Pick Footer. The header runs before your page is drawn; the footer runs after, which is why the assistant can’t slow anything down.

You used the theme editor and an update erased it

Symptom: it worked for weeks, then quietly stopped.

If you pasted into Appearance → Theme File Editor, the next theme update overwrote that file. Redo it with WPCode instead — the whole reason to use a plugin is that updates leave it alone.

A caching plugin is serving the old page

Symptom: you saved it, but your site looks unchanged.

WP Rocket, W3 Total Cache, LiteSpeed and similar plugins keep a saved copy of your pages. Find Clear Cache or Purge All in the top admin bar, then reload with Cmd/Ctrl + Shift + R.

Squarespace

Settings→Developer Tools→Code Injection→Footer

What you’re looking for

A page with two large empty boxes, one labelled Header and one labelled Footer. You want the second one. On some accounts the menu path is Settings → Advanced → Code Injection instead — same page, same two boxes.

  1. Log in and open the site you want the assistant on.
  2. In the left sidebar, click Settings.
  3. Click Developer Tools, then Code Injection. (If you don’t see Developer Tools, look under Advanced.)
  4. Find the second box, labelled Footer. Click inside it.
  5. Paste your line. Don’t delete anything already in the box — add yours on a new line.
  6. Click Save at the top left.

Check it worked

Open your live address in a new tab. The Squarespace editor won’t show it — it blocks this kind of code on purpose — so you must look at the real site.

Code Injection isn’t there at all

Symptom: no Developer Tools, no Code Injection anywhere in Settings.

Code Injection needs a Business plan or higher. Personal plans don’t include it. If you’re on Personal, email me before upgrading — there may be a better answer for your setup than paying Squarespace more.

It went in the Header box

Symptom: nothing appears, or the page stalls before drawing.

The two boxes look identical and sit one above the other. Cut it from Header, paste into Footer, save again.

You’re looking at the editor preview

Symptom: saved, no errors, still no button.

Squarespace’s editor deliberately doesn’t run injected code. Open your actual web address in a separate tab. If it’s still missing there, hard refresh with Cmd/Ctrl + Shift + R.

Wix

Dashboard→Settings→Custom Code→+ Add Custom Code

What you’re looking for

A panel titled Custom Code, listing any snippets you already have. The + Add Custom Code button is at the top right. The form that opens has a code box, a name field, an Add Code to Pages choice, and a Place Code in dropdown — that last one is the part people get wrong.

  1. Log in and open your site’s Dashboard.
  2. In the left sidebar, click Settings. Scroll to the Advanced group and click Custom Code.
  3. Click + Add Custom Code at the top right.
  4. Paste your line into the code box.
  5. Name it Valiton assistant so you recognise it later.
  6. Under Add Code to Pages, choose All pages, and leave “Load code once” selected.
  7. Under Place Code in, choose Body – end.
  8. Click Apply.
  9. Go back to your editor and click Publish at the top right.

Check it worked

Open your published address — the .wixsite.com one or your own domain — in a new tab. Not the editor.

You didn’t press Publish

Symptom: applied successfully, nothing on the live site.

Wix keeps every change in draft until you publish. Clicking Apply on the code panel is not publishing. Open the editor and click Publish at the top right. This is the single most common one.

Place Code in was left on “Head”

Symptom: published, still nothing.

The dropdown defaults to Head. Reopen the snippet and change it to Body – end, then apply and publish again.

It’s only on one page

Symptom: the button appears on your home page but nowhere else.

Under Add Code to Pages, “Choose specific pages” was picked instead of All pages. Edit the snippet and switch it — visitors land on service pages from Google as often as on your home page.

A hand-built site

your template or every .html file→immediately before </body>

What you’re looking for

Near the bottom of each page’s file there’s a line reading </body>, usually with </html> just after it. Your line goes on its own line directly above </body>. If whoever built your site used a template, header or footer include, put it there once instead of in every file.

  1. Open your site’s files — however you normally edit them: an editor, cPanel’s File Manager, FTP, or your host’s dashboard.
  2. Open the page file, or your shared footer template if you have one.
  3. Scroll to the bottom and find </body>.
  4. Paste your line on its own line just above it.
  5. Save, and upload if your editor doesn’t do that for you.
  6. Repeat for every page, unless you used a shared template.

Check it worked

Load your site and hard refresh with Cmd/Ctrl + Shift + R. Check a second page too, so you know the template did its job.

It landed after </body>

Symptom: nothing appears, and nothing looks broken either.

Anything after the closing body tag is outside the page. Browsers usually forgive it, but not always. Move it one line up, so it sits above </body>.

Your browser is showing the old file

Symptom: uploaded, but the page looks identical.

Hard refresh with Cmd/Ctrl + Shift + R. If your host or Cloudflare sits in front of your site, clear its cache too.

Only one page has it

Symptom: it works on the home page, missing everywhere else.

Without a shared template, every .html file needs its own copy. Search your files for </body> to find the ones you missed.

If it isn’t working

  1. Look at the live site, not the editor. Every platform’s preview blocks this kind of code. Open your real web address in a normal tab.
  2. Hard refresh. Cmd + Shift + R on a Mac, Ctrl + Shift + R on Windows. Your browser holds onto the old version of a page longer than you’d expect.
  3. Confirm it’s in the footer or body-end box, not the header or head. This is the cause more often than everything else combined.

Still nothing? Email me at luke@valiton.org with your web address and which platform you’re on. Don’t spend a second evening on it.

Or let me do it

Send me a temporary login and I’ll install it, check it on a phone and a laptop, and delete my access when I’m done. It takes me about five minutes and costs nothing. This is included — you’re not imposing.

luke@valiton.org