Skip to main content

WordPress

Three ways to do this. Use the first one that fits.

Option 1 — A header/footer scripts plugin (recommended)​

The safest route, because it survives theme updates.

  1. Install a plugin such as WPCode or Insert Headers and Footers
  2. Open its settings
  3. Paste your snippet into the Footer or Body section — not the header
  4. Save

Done. The widget appears on every page.

Why the footer?

The snippet loads asynchronously either way, so it will work in the header too. Footer is the convention and keeps your <head> tidy.

Option 2 — Theme customizer​

Some themes — Astra, GeneratePress, Kadence and many commercial themes — have a built-in code injection area.

Look under Appearance → Customize for a section named Custom Code, Scripts, or Footer Code. Paste the snippet there and publish.

Option 3 — Editing the theme directly​

Only if neither of the above is available.

Use a child theme

Editing a parent theme's files means the next theme update silently deletes your snippet. Always do this in a child theme.

  1. Appearance → Theme File Editor
  2. Open footer.php
  3. Paste the snippet immediately before </body>
  4. Update the file

WooCommerce​

The widget works on WooCommerce stores with no extra setup.

Consider whether you want it on the checkout page. A floating chat bubble during payment can be a helpful reassurance or an unwanted distraction, depending on your audience. If you want it off checkout, use a plugin that supports conditional display rules rather than site-wide injection.

Caching plugins​

If you use WP Rocket, W3 Total Cache, LiteSpeed Cache or similar, clear the cache after adding the snippet. Otherwise visitors keep getting the old cached page without it, and you will conclude the install failed when it did not.

Also check any combine or defer JavaScript optimisation settings. Aggressive JavaScript optimisation occasionally interferes with third-party scripts. If the widget does not appear, temporarily disable those options to test whether they are the cause.

It is not showing up​

  1. Clear your caching plugin's cache
  2. Hard-refresh the page (Ctrl+Shift+R)
  3. View the page source and search for ChatbotConfig — if it is not there, the snippet was not saved where you thought
  4. Open the browser console and read any errors

→ Widget troubleshooting