Drupal is a powerful open-source content management system used by businesses, governments, and educational institutions worldwide. This guide shows you how to add the Smartsupp live chat and chatbot widget to your Drupal site — modern instructions for Drupal 9, 10, and 11, plus a separate section for legacy Drupal 7.
We've broken the guide into the following sections:
Copy the Smartsupp code
Log in to your Smartsupp dashboard and go to Settings > Chatbox > Installation > Insert code. Copy the entire code snippet.
Add a custom block (Drupal 9, 10, 11)
Modern Drupal lets you insert the Smartsupp code through a custom block — no extra modules required. Log in to your Drupal admin panel and go to Structure > Block layout > Custom block library. Click Add custom block, give it a name (for example "Smartsupp"), and paste the Smartsupp code into the body field. Switch the text format to Full HTML so the script tag is preserved, then click Save.
Place the block on your site
Now tell Drupal where the block should appear. Go back to Structure > Block layout, find a region (for example Footer or Content), click Place block, choose your Smartsupp block, and save the configuration. The widget loads on every page where the region is rendered, so it's available across your entire site.
Install on Drupal 7 (legacy)
If you're still running Drupal 7, the steps are different — you'll need a third-party module to insert custom code in the page header.
Heads up: Drupal 7 reached end of life in January 2025 and no longer receives security updates. We recommend upgrading to Drupal 10 or 11. The steps below rely on the third-party Add To Head module — Smartsupp is not responsible for its behaviour and doesn't provide support for it.
1. Install the Add To Head module. Download the Add To Head module as a .ZIP file. In your Drupal admin go to Modules > List, click Install new module, upload the ZIP, and click Install.
2. Enable the module. Once installed, the module won't run until you activate it. Find Add To Head in your module list, tick the checkbox, and save the configuration.
3. Create a profile and insert the code. Go to the Add To Head settings, create a new profile (for example "Smartsupp"), paste the Smartsupp code into the snippet field, configure where it should appear, and save.
Verify the installation
Open your Drupal site in a new browser tab and refresh the page. The Smartsupp chat widget should appear in the corner of your site. Log in to your Smartsupp dashboard to start chatting with visitors.
Tip: If the chat widget doesn't show up, clear Drupal's cache (Configuration > Performance > Clear all caches) or open your site in an incognito window. On Drupal 9/10/11 also make sure the Full HTML text format is set on the block body and that the block is placed in a visible region.
Related resources:
Smartsupp installation — full overview of all installation methods.
Why can't I see the chat on my website? — troubleshoot the most common installation issues.
What's next?
Basic chat box settings — customize colors, position, welcome messages, and more.
Chat box status — learn how the chat widget status works and how to control it.
Why can't I see the chat on my website? — troubleshoot the most common installation issues.
Download plugins — explore all available platform integrations.