# Install Tidio with Google Tag Manager

Section: Install Tidio

Description: Install Tidio through Google Tag Manager, preview and publish your tag, and exclude checkout pages without loading the widget twice.

Verified against Tidio panel 12.331.0

Last updated: 2026-11-19

Source: https://help.tidio.com/articles/install-google-tag-manager/

Add Tidio to your website through a Google Tag Manager web container. Use one custom HTML tag to load the widget once per page load.

**In this article, you'll learn:**

- [How to copy your Tidio code](https://help.tidio.com/articles/install-google-tag-manager/#copy-code)
- [How to add the Tidio tag in Google Tag Manager](https://help.tidio.com/articles/install-google-tag-manager/#install)
- [How to check the installation](https://help.tidio.com/articles/install-google-tag-manager/#check)
- [How to exclude the checkout page](https://help.tidio.com/articles/install-google-tag-manager/#hide-on-pages)
- [How to troubleshoot the installation](https://help.tidio.com/articles/install-google-tag-manager/#troubleshooting)

[Video](https://help.tidio.com/article-media/install-google-tag-manager/walkthrough.mp4)

Silent walkthrough. Opening Settings > Live Chat > Installation, choosing Manual install and copying the code snippet.

## Copy your Tidio code

1. Log in to your Tidio panel.
2. Go to **Settings > Live Chat > Installation**.
3. Choose **Manual install**.
4. Click **Copy to clipboard**.

Your code has this form. Use the code you copied, or replace ` YOUR_PUBLIC_KEY ` with your project's Public key:

```
<script src="//code.tidio.co/YOUR_PUBLIC_KEY.js" async></script>
```

![Settings > Live Chat > Installation with Manual install selected, the code snippet visible, and the Copy to clipboard button.](https://help.tidio.com/article-media/install-google-tag-manager/installation-manual-install.png)

## Add the Tidio tag in Google Tag Manager

Start with a Google Tag Manager web container already installed on your website. If you do not have one, follow Google's [container installation guide](https://support.google.com/tagmanager/answer/14847097?hl=en) first.

1. Open your site's container in Google Tag Manager.
2. Select **Tags**, then **New**. Give the tag a name such as Tidio chat widget.
3. Click **Tag Configuration** and choose **Custom HTML**.
4. Paste the complete Tidio script into the HTML field, including its opening and closing tags.
5. Click **Triggering** and select **Initialization - All Pages** as the only firing trigger.
6. Click **Save**.
7. In **Workspace**, click **Preview**. Enter your website URL and click **Connect**.
8. Return to Tag Assistant and click **Continue**. Complete the checks below before publishing.
9. Return to **Workspace** and click **Submit**. Select **Publish and Create Version**, enter a version name and description, then click **Publish**.

With this setup, the Tidio script loads once per page load through the container. In a single-page app, use the initial-load trigger only. Do not add a **History Change** trigger to the installation tag. The widget stays loaded as visitors move between routes.

Keep only one Tidio installation. Remove any existing copy from your website code, plugin or another container before publishing this tag.

Google documents [custom HTML tags](https://support.google.com/tagmanager/answer/6107167?hl=en), [page-load triggers](https://support.google.com/tagmanager/answer/7679319?hl=en) and [previewing and publishing](https://support.google.com/tagmanager/answer/14842769?hl=en).

## Check the installation

Open your site in a regular browser window. The chat widget appears in the corner of the page and stays there when you move between pages. Headless and automated browsers may not show the widget, so do not rely on them for this check.

Loading a page with the widget is what activates it. After that, **Settings > Live Chat > Installation** in your Tidio panel says **Chat Widget is installed properly**.

Check the live site after publishing your Google Tag Manager container.

In GTM **Preview**, use Tag Assistant to confirm that your Tidio tag fires once for each full page load. In a single-page app, navigate to another route and check that the installation tag does not fire again. Google explains how to inspect tag firing in [preview and debug mode](https://support.google.com/tagmanager/answer/6107056?hl=en).

## Exclude the checkout page

To prevent the tag from loading on a direct visit to ` /checkout `, add a trigger exception. Match the exception's event type to your installation trigger.

1. Open **Triggers** and click **New**. Name the trigger Exclude checkout.
2. Click **Trigger Configuration** and choose **Initialization**.
3. Under **This trigger fires on**, restrict the trigger to matching events. Set the filter to **Page Path**, the equals operator and the value ` /checkout `.
4. Save the trigger. Open your Tidio tag and click **Triggering**.
5. In **Exceptions**, click **Add** and select the checkout trigger. Save the tag.
6. Preview a direct visit to ` /checkout ` and confirm that the tag does not fire. Check another page to confirm that it still fires there, then submit and publish the changes.

This exact match covers ` /checkout `, not ` /checkout/ ` or checkout subpages. Add matching exceptions for any other checkout paths your site uses.

A trigger exception prevents loading. It does not hide a widget that already loaded on another route in a single-page app. It also does not load the widget when you leave an excluded route without a full page load. For route-aware control, see the [Widget SDK](https://help.tidio.com/articles/widget-sdk/).

To load the widget only on a list of addresses instead, see [Show the widget only on specific pages](https://help.tidio.com/articles/show-widget-only-on-specific-pages/).

Google documents [trigger exceptions](https://support.google.com/tagmanager/answer/7679318?hl=en) and [page-path filters](https://support.google.com/tagmanager/answer/7679102?hl=en).

## Troubleshooting

- If the tag works in preview but not on the live site, publish the container. Saving a tag or creating a version without publishing does not make the changes live.
- If the tag fires again during navigation in a single-page app, remove any **History Change** trigger from the installation tag. That trigger responds to history changes, not just full page loads.
- If you see duplicate widget requests, check for a second installation tag or container. Also check your page source and website plugins for an existing Tidio script. Keep one installation.
- If consent blocks the tag, review **Advanced Settings > Consent Settings** and **Additional Consent Checks**. With **Require additional consent for tag to fire**, all specified consent types must be granted when the trigger runs. Keep your site's consent requirements and test the intended consent flow rather than disabling those checks.
- If the tag never fires, confirm that the container is installed on that page and inspect its triggers and exceptions in preview.
- If the tag fires but the widget does not appear, check that the script uses your project's Public key rather than ` YOUR_PUBLIC_KEY `.

See Google's documentation for [history change triggers](https://support.google.com/tagmanager/answer/7679322?hl=en) and [tag consent settings](https://support.google.com/tagmanager/answer/10718549?hl=en).

## Further reading

[Integrate Tidio with Google Tag Manager](https://help.tidio.com/articles/integration-google-tag-manager/) covers sending Tidio events to the ` dataLayer `, which is different from installing the widget.

- [Install Tidio on your website](https://help.tidio.com/articles/install-website/)
- [Widget SDK](https://help.tidio.com/articles/widget-sdk/)
