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="https://global.localizecdn.com/localize.js"></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>
<script>
Localize.initialize({
key: '[[app:key]]',
rememberLanguage: true,
// other options go here, separated by commas
});
</script>
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, 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
- Visit your website/application in a browser.
- Select one of your target languages using the language switching widget.
- Refresh the page.
- 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 15 days ago
What's Next
| Next Steps |