Install with Google Tag Manager

If you already run Google Tag Manager, you can deploy the widget without touching your site's code.

This guide assumes the GTM container snippet is already installed on your site.

Create the tag

1. Open tagmanager.google.com and select your container.
2. Go to Tags → New.
3. Name it something recognisable, like HelpShelf Widget.
4. Click Tag Configuration and choose Custom HTML.
5. Paste your snippet from the HelpShelf dashboard:

<script src="https://app.helpshelf.com/widget/YOUR_SITE_HASH.js" data-helpshelf-site="YOUR_SITE_HASH" async></script>

Leave the advanced settings at their defaults.

Set the trigger

1. Click Triggering and choose All Pages.
2. If you only want the widget on part of your site, create a Page View trigger with a path condition instead — but in most cases All Pages is what you want, since visitors can need help anywhere.

Publish

Click Save, then Submit and Publish to push the container live. Load your site in a new tab and the launcher should appear.

Troubleshooting

The widget doesn't appear after publishing. Use GTM's Preview mode to confirm the tag is firing on the page you're testing. If it fires but nothing renders, check the browser console for [HelpShelf] messages.

Consent mode. If your GTM setup blocks tags until a visitor accepts cookies, the widget won't load until then. The HelpShelf widget doesn't set advertising cookies, so most sites classify it as functional rather than marketing — check with whoever owns your consent policy.