Getting Content into Localize

Determine how you will use Localize for your Project

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

If you haven't already, first follow the instructions for Signing Up.

Navigate to the Project Overview screen and select from one of the Import Content options for installing Localize:

Option 1: Install Localize on your Website

First check if your website is hosted on one of the platforms for which we have an integration guide. If yes, click on it and you can follow our instructions for that specific platform.

If not, then follow the instructions below to install the code snippet.

Step 1: Install the Code Snippet

Copy and paste the following code snippet between the <head> and </head> tags in your website's source code, in every page that you want to Localize. (If you're not a developer, send your developer a link to this page, or contact us for a product demo!)

<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","hideWidget","showWidget"],t=0;t<e.length;t++)a.Localize[e[t]]=function(){}}}(window);</script>

    key: '[[app:key]]', 
    rememberLanguage: true,
    // other options go here, separated by commas



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, and may cause other problems like your source language flashing on the screen before the target language is displayed.

Step 2: Verify successful installation

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

Step 3: Load your website in a browser

  1. Visit your website/application in a browser.
  2. Select one of your target languages using the language switching widget.
  3. Refresh the page.
  4. Lather, rinse, repeat, for each page in your site.

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


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

Does the code copied into your site contain "YOUR-PROJECT-KEY" or "[[app:key]]" next to the "key: " line in the code snippet? If so, replace "YOUR-PROJECT-KEY" or "[[app:key]]" with your unique Project Key found on the Project Overview page.

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

Step 4: Check for Phrases in the Dashboard

Then check your Phrases tab to review your content.

If you're not seeing phrases show up in the dashboard, see our troubleshooting tips here.

Step 5: Next Steps

Click here to continue onto the Next Steps.

Option 2: Use our REST API

If you're not translating a website or web application, refer to our:

  • REST API docs for API endpoints for managing phrases and translations on the backend.
  • Localize CLI docs for Command Line Interface for importing and exporting string files

The REST API can be used in your mobile applications in a variety of ways, read more here.

The REST API may also be used for websites, but that isn't the typical use case.

Option 3: Use the Files Method

Use the file import/export feature to manage your translations in the Localize dashboard.

  • This is useful for mobile apps which use static text, bundled with the app.
  • Files with source language can be imported into the dashboard.
  • Files can then be exported from the dashboard and sent out to your translators.
    • Once translations are completed, the combined file can be imported back into the dashboard.
  • You can also invite your translators to your team and allow them to add translations directly in the dashboard.

Advanced Installation

Please refer to the following guides for advanced integration steps:

ā€” Using HTML Syntax to Prepare Phrases. Must-read if integrating with a dynamic application
ā€” Frontend API. Interact with Localize in your client-side Javascript code

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

Questions? Don't hesitate to contact us. We're here to help!

Updated 9 days ago

What's Next

Next Steps

Getting Content into Localize

Determine how you will use Localize for your Project

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.