Developer Docs >
Help Center
Try it FreeLearn MoreYour AccountSupport

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.

Suggest Edits

If you are already using Google Tag Manager (GTM) for your website and can't integrate the Localize code snippet 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!
If you are not using GTM, check out what it can do for you here.

🚧

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
  1. Select Tag Configuration
  1. Select Discover more tag types...
  1. Search for Localize TMS Integration then select it.
  1. Select Add to workspace
  1. Confirm by clicking Add

  1. Enter your Localize Project Key
  1. Don't forget to name your tag by replacing "Untitled Tag"
  2. Select a trigger
    a. Here's where you can select on which pages you would like to use Localize.
  1. Save your new tag

2. Reload your website

  1. Visit your website in a browser. You should now see the default Localize language-switching widget.
    a. If you don't, contact support and we can give you a hand.
  2. Select one of your target languages using the language-switching widget.
  3. Refresh the page.
  4. Lather, rinse, repeat, for each page on your site.

Localize will automatically begin to detect new content on the pages that you visit, and will bring it into your dashboard.

3. Approve phrases

Then head on over to the Manage Phrases page to approve phrases in the Localize dashboard.

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.

Need Help?
Contact support for custom integration help or troubleshooting!

Updated 10 months ago