Skip to main content

Install Witzo on WordPress

Add the Witzo widget to WordPress using a site-wide footer method, then verify that the chat works correctly on the live site.

Overview​

Witzo installs on WordPress by adding your widget script to a global location. The safest approach is to use a header/footer plugin so the script remains in place when the theme is updated.

Using a plugin such as WPCode or Insert Headers and Footers is safer than editing theme files directly, because theme updates can overwrite manual changes to footer.php.

  1. Install a header/footer plugin such as WPCode.
  2. Open Settings > Header & Footer.
  3. Paste the Witzo embed script into the Footer Scripts section.
  4. Save changes.

Manual Theme Method​

Use this method only if your workflow requires direct theme editing.

  1. Copy your embed script from the dashboard.
  2. Open Appearance > Theme File Editor > footer.php.
  3. Paste the script before the closing </body> tag.
  4. Save the file.
WordPress footer installation example for the Witzo widget

Clear Cache​

  • Clear your WordPress cache plugin such as WP Rocket, LiteSpeed, or W3 Total Cache.
  • Clear server cache if hosted on managed hosting.
  • Clear CDN cache if you use Cloudflare or another provider.
  • Hard refresh your browser with Ctrl + Shift + R.

Testing Checklist​

  • Widget appears on your website
  • No console errors appear in browser DevTools
  • You can open the widget and send a test message
  • AI responds correctly
  • Conversations appear in Dashboard > Conversations
  • Usage updates in Dashboard > Analytics

Important Notes​

  • Always use the correct widget key.
  • Add the script globally for site-wide coverage.
  • Direct edits to footer.php can be lost when the theme is updated.
  • If you use page builders such as Elementor, avoid adding the script inside individual pages.