Getting Started Documentation

Localize installation guide for Websites and Web Applications

Installing Localize is simple and shouldn't take more than a few minutes. If you run in to any problems, contact us and we'll be happy to assist!

If you're not translating a website or web application, refer to our Backend API and Localize CLI documentation for API or file-based integration.

STEP 1: Create an Organization and Project

If you don't have a Localize account, sign up here.

If you're not a developer, send your developer a link to this page, or contact us for a product demo!

Then create your first project.

STEP 2: Installing Project Key Code Snippet

Copy and paste the following code snippet between the <head> and </head> tags in your website's source code.

<script src=""></script>
<script>!function(a){if(!a.Localize){a.Localize={};for(var e=["translate","untranslate","phrase","initialize","translatePage","setLanguage","getLanguage","detectLanguage","getAvailableLanguages","untranslatePage","bootstrap","prefetch","on","off"],t=0;t<e.length;t++)a.Localize[e[t]]=function(){}}}(window);</script>

    key: '[[app:key]]', 
    rememberLanguage: true

IMPORTANT: Ensure the code snippet is placed after the <head> and before the </head> tag. Placing the Localize code in the <body> of your site will have a negative impact on performance.

STEP 3: Verify Successful Installation

After installing the code snippet, refresh your application. If you see the Localize widget on the bottom left of your site, Localize is successfully installed! Congratulations!

If you don't see the Localize widget after refreshing the page

Does the code copied into your site contain "YOUR-PROJECT-KEY" at the end of the code snippet? If so, replace "YOUR-PROJECT-KEY" with your unique Project Key found on your API Keys page.

If you're still having trouble, contact us for assistance!

STEP 4: Reload Your Application

After installing the code, visit your application and select your target language. Refresh your application and visit all the pages that you would like to have translated. This allows us to detect your phrases and load them onto your Localize Dashboard.

Then check your Phrases tab to review your content.

STEP 5: Approve Content for Translation

In order to begin translating your site, you must approve the phrases you wish to be translated.

More information on the phrase approval process can be found in our "Approve Phrases" guide.

STEP 6 (Optional): Order Translations

Localize will automatically generate machine translations from Google Translate for each phrase you approve. We recommend using machine translations for testing purposes only, since the quality of machine translations aren't very good.

To professionally translate your content, you can:
Order translations from our network of professional translators, or...

STEP 7 (Optional): Propose and Edit Translations

Invite your in-house translation team to your Localize account to translate your content.

STEP 8 (Optional): Review Translations In Our Editor

STEP 9 (Optional): Customize the Widget

STEP 10 (Optional): Add More Languages

STEP 11 (Optional): Invite Team Members

Finally... Subscribe to a plan (after your Free Trial)!

Advanced Installation

Please refer to the following guides for advanced integration steps:

HTML Syntax. Must-read if integrating with a dynamic application
Frontend API. Interact with Localize in your client-side Javascript code
Backend API. API endpoints for managing phrases and translations on the backend
CLI. Command Line Interface for importing and exporting string files

We hope this was a helpful introduction to the Localize platform!

Get in touch with us if you have any questions. We're here to help.