---
agentTools:
  projectIndex: https://help.localizejs.com/llms.txt
---

# Translate w/ Google Tag Manager

This Google Tag Manager integration guide shows you how to translate your website in a few easy steps. Follow this tutorial to create a multilingual website using Google Tag Manager translated to other languages for your international customers.

If you are already using Google Tag Manager (GTM) for your website and can't [integrate the Localize code snippet](https://help.localizejs.com/docs/installation) directly into your website, then you can integrate Localize into your website by using our custom **Tag**.

> 📘 Using GTM is Not the Preferred Method
>
> Using GTM is not the preferred method to install Localize in your website. If you are able to add the Localize code snippet directly to your website, that is the preferred method.
>
> In the past we've had instances where using the Localize Tag in GTM has caused problems for customers that was fixed after they directly installed the code snippet.

Below is a step by step guide for integrating Localize into your website using GTM.

If you do not have a Localize Project yet, [signup here](https://app.localizejs.com/signup)!\
If you are not using GTM, <a href="https://marketingplatform.google.com/about/tag-manager/" class="external-link" target="_blank">check out what it can do for you here</a>.

> 🚧 GTM is Already Installed
>
> These instructions assume that you've already installed the 2 required code snippets for GTM into your website, following the instructions here: <https://support.google.com/tagmanager/answer/6103696?hl=en>

## 1. Add Localize Tag in GTM

1. Login to GTM
2. Navigate to the desired Workspace, or create a new one
3. Select **New Tag**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/3ee0b75-GTM_New_Tag.jpg",
        "GTM New Tag.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

4. Select **Tag Configuration**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/6b0d99b-GTM_Tag_Config.jpg",
        "GTM Tag Config.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

5. Select **Discover more tag types...**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/4a046b7-GTM_Search_for_Tag-choose_tag_type.png",
        "GTM Search for Tag-choose tag type.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

6. Search for **Localize TMS Integration** then select it.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/96e10e2-GTM_Search_for_Tag-Enter_tag_name.png",
        "GTM Search for Tag-Enter tag name.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

7. Select **Add to workspace**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/050eda4-Add_to_Workspace.jpg",
        "Add to Workspace.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

8. Confirm by clicking **Add**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/0afeec5-Add_to_Workspace_confirmation.png",
        "Add to Workspace confirmation.png",
        null
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

9. Enter your [Localize Project Key](https://app.localizejs.com/project)

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/2f6db0d-GTM_Add_Project_Key.jpg",
        "GTM Add Project Key.png",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

10. Don't forget to name your tag by replacing "Untitled Tag"
11. Select a trigger\
    a. Here's where you can select on which pages you would like to use Localize.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/445d0d9-GTM_Choose_Trigger.jpg",
        "GTM Choose Trigger.png",
        ""
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

12. Save your new tag

## 2. Reload your website

1. Visit your website (or application).
2. Select one of your **target languages** using the language-switching widget.
3. Refresh the page.
4. Lather, rinse, and repeat, for each page on your site.

Localize will automatically begin detecting new content on the pages you visit and bring it into your dashboard.

## 3. Approve phrases

Then head on over to the [Manage Phrases page](https://app.localizejs.com/phrases?page=1\&state=pending\&pageFilter=all) to [approve phrases](https://help.localizejs.com/docs/approve-content-for-translation) in the Localize dashboard.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/182d38b-Pending_Phrases_Bin.png",
        "Pending Phrases Bin.png",
        null
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

### Phrases not showing up?

If you are not seeing phrases show up in your Pending bin in the Localize dashboard, [follow the troubleshooting instructions here](https://help.localizejs.com/docs/my-dashboard-is-empty).

***

**Need Help?**\ <a class="open-widget">Contact support</a> for custom integration help or troubleshooting!