Google Tag Manager

Ship the Patchrooms loader as a GTM tag so it goes out through your existing tag management workflow instead of a code change.

Prerequisites

• Publish access to a GTM container already installed on your site.
• A project key (pr_…) from your Patchrooms dashboard, under Settings.

Public vs secret keys

A pr_… project key is public and safe to paste into a GTM tag. A secret pr_sk_… key (used for MCP access) must never go into a tag or trigger.

Add the tag

1. In GTM, go to Tags → New.

2. Set Tag Configuration to Custom HTML, and paste:

   <script src="https://room.patchrooms.com/v1/patchrooms/pr_xxx.js"></script>

   Replace pr_xxx with your project key.

3. Set Triggering to All Pages (or a narrower trigger if you only want the widget on specific paths, e.g. a staging path).

4. Save the tag, then Submit and Publish the container.

Note

GTM tags load asynchronously, after the page’s own scripts. The Patchrooms launcher will appear a beat after the rest of the page — this is expected, not a broken install.

Check it in Preview mode before publishing

Use GTM’s Preview mode to confirm the tag fires before you publish the container to everyone:

1. In GTM, click Preview and enter your site’s URL.

2. In the Tag Assistant debugger, confirm the Custom HTML tag fired on page load (look for it under the page-load event).

3. In the site tab itself, confirm the Patchrooms launcher appears docked to the edge of the viewport.

Verify it works

1. Load the published page (or the Preview-mode tab, if you’re checking before publishing).

2. Confirm the launcher appears.

3. Click it, leave a text block, and submit. The report should appear in your project’s Feedback tab within a few seconds.

If the launcher never appears even with the tag firing, see Troubleshooting — check the browser console for [Patchrooms] unknown project key, which means the pr_xxx placeholder in the tag wasn’t swapped for your real key.