Installing the Chat Widget on Your Website

InstallationUpdated March 26, 2026

Widget Installation Guide

The Helpium chat widget lets customers search your knowledge base and start live chat conversations directly from your website.

Getting Your Widget Code

  1. Go to Settings → Channels → Widget
  2. Your widget embed code is displayed at the top of the page
  3. Copy the full code snippet

Adding the Widget to Your Website

Paste the code snippet just before the closing </body> tag on every page where you want the widget to appear:

<script>
(function(w,d,s,o,f,js,fjs){
  w['Helpium']=o;w[o]=w[o]||function(){
    (w[o].q=w[o].q||[]).push(arguments)};
  js=d.createElement(s);fjs=d.getElementsByTagName(s)[0];
  js.id=o;js.src=f;js.async=1;
  fjs.parentNode.insertBefore(js,fjs);
}(window,document,'script','helpium',
  'https://your-domain.com/widget/helpium-widget.js'));

helpium('init', { apiKey: 'YOUR_WIDGET_KEY' });
</script>

Verifying the Installation

After adding the code, refresh your website. You should see the chat icon in the corner of the screen (the position is configurable in widget settings).

Troubleshooting

  • Widget not appearing? Check your browser console (F12) for errors
  • Wrong API key? Verify the key matches the one in Settings → Channels → Widget
  • Ad blockers may prevent the widget from loading. Test in an incognito window

Was this article helpful?

Need more help?

Our support team is available to assist you with any questions.

Contact Support