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. and create your Organization.

Then create your first project.

STEP 2: Add Localize to Your Application

There are a number of ways to add Localize to your application:

  • Option 1: Install the Localize Code Snippet
  • Option 2: Use one of our Integration Guides
  • Option 3: Use our Backend API
  • Option 4: Use the Files Method

You can follow the instructions here for any of the above options.

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 not, check here for next steps.

STEP 4: Reload Your Application

  1. Visit your website 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.

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: Approve Content for Translation

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

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.

Getting Started Documentation

Localize installation guide for Websites and Web Applications

Suggested Edits are limited on API Reference Pages

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