Skip to content

Add Aliendesk with Google Tag Manager

Already use Tag Manager? Add the widget as one Custom HTML tag, without touching your site code.

Install guide

What you need

  • An Aliendesk account
  • A Tag Manager container that is already installed on your site
  • Permission to publish that container

Install it

  1. Step 1: Copy your snippet

    In Aliendesk, open Settings → Live chat widget and copy the script tag under Install. It already contains your brand key.

  2. Step 2: Create a tag

    In Tag Manager, open Tags and click New.

  3. Step 3: Choose Custom HTML

    Click Tag Configuration, choose Custom HTML and paste the snippet. Name the tag, for example Aliendesk widget.

    Custom HTML
    <script src="https://widget.aliendesk.io/loader.js" data-brand="YOUR_BRAND_KEY" data-api="https://app.aliendesk.io" async></script>
  4. Step 4: Fire it on every page

    Under Triggering, choose All Pages, then click Save.

  5. Step 5: Publish

    Click Submit, then Publish, to put the change live.

  6. Step 6: Allow your domain

    Back in Settings → Live chat widget, add your website's domain under Allowed domains. The widget then only runs on your own sites.

  • You do not need the Support document.write option. Tag Manager may rewrite quotes in the snippet when it minifies it, which is harmless.
  • If a consent tool or blocker stops Tag Manager from loading, the widget will not load either.

Check it works

  1. Open your website in a private window. The chat launcher appears in the corner once the page has finished loading.
  2. Open it and ask something your website answers. The reply shows the page it came from.
  3. In Aliendesk, open your inbox. The conversation is already there.

Not ready to touch your site yet? Use Open test page in Settings → Live chat widget to try the widget on a plain page first.

Troubleshooting

The widget doesn't show up
Open your live site in a private window and wait for the page to finish loading: the widget loads after your page so it never slows it down. Then view the page source and search for loader.js to check the snippet made it onto the published page, with your brand key in data-brand.
It works on one domain but not another
Add every domain the widget runs on, including www, staging and preview domains, under Allowed domains in Settings → Live chat widget. While you test, you can leave the list empty to allow any site.
Caching or optimisation tools
Clear your site and CDN cache after adding the snippet. If a plugin or service combines, minifies or delays JavaScript, exclude widget.aliendesk.io/loader.js from it.
Ad blockers and privacy extensions
Some browser extensions block chat widgets. Test in a private window with extensions turned off before changing anything else.

Still stuck? Ask in the chat, or email support@aliendesk.io. To pass signed-in users or listen for widget events, read the developer docs.

Platform steps checked against Tag Manager Help: custom tags, Tag Manager Help: triggers on 18 October 2026. Menus can move; follow the platform's own docs if they differ.

Beam it up

Put an AI agent on your website today

Billed monthly. No lock-in.