All platform guides

Add the selector through Google Tag Manager

OtherCustom HTML tag

Tested by us on a real site, last checked 2026-08-04.

Use this if you already have Tag Manager and cannot edit your theme, or need approval to.

Where the snippet goes

Copy the snippet from Settings, then Selector, in your project.

  1. In Tag Manager, click Tags, then New.
  2. Click Tag Configuration and choose Custom HTML.
  3. Paste the snippet into the HTML field, whole and unchanged. Leave Support document.write switched off, our script does not need it.
  4. Under Triggering, choose the trigger that fires on every page view.
  5. Give the tag a name, then Save.
  6. In the Workspace tab, click Submit, top right.
  7. On the Submit Changes screen, keep Publish and Create Version selected, fill in Version Name and Version Description, then click Publish, top right.

Submit on its own does not publish anything, it opens the version screen. Close that screen without clicking Publish and your tag is still sitting in the workspace, with nothing on your live site.

The trap on Google Tag Manager

The snippet must keep its data-ut-tenant attribute. That attribute is what tells the script which project it belongs to. Without it the file still loads, so everything looks installed, and no selector ever appears.

This matters more here than anywhere else, because the HTML field is a free text box and the snippet is right there to be tidied up. Do not reformat it, do not retype it, and do not copy out just the src URL. Paste the whole tag exactly as the Selector screen gives it to you.

Two smaller things. Tag Manager loads after your page, so the selector appears slightly later than it would from a snippet in your head. And Tag Manager cannot put the placement element at a chosen spot inside your menu markup. Try the picker (Settings, then Selector, pick a position, and open your menu inside the picker before clicking the spot you want). If you need an exact position in the menu, paste the placement element into your theme instead, or use a header, footer, or floating selector.

How to know it worked

Tag Manager has the best check of any platform, so use it before you publish. In the Workspace tab, click Preview, top right, enter your site's URL, and click Connect. Your site opens in a new window and shows as Connected in the bottom right. Tag Assistant opens alongside your site and shows which tags fired on the page you are looking at. Your tag should be in the fired list. Preview proves the tag works, but it does not put it on your live site. You still have to Publish.

Once published, open your live site, right-click, choose Inspect, open the Elements panel and search for ut/v1.js. One match means it is live. Do not use view-source here. Tag Manager adds our script after the page loads, so the raw source shows your container snippet and not ours, even on a perfectly good install.

The check on the Selector settings screen cannot see a Tag Manager install and stays red however long you wait. It reads the HTML your site sends, which is the same reason view-source does not show the script, so trust Tag Assistant and the Elements panel here instead. On other platforms a red check straight after publishing means "not yet", not "it failed".