Migrating from Phrase to locize

If you want to move your translations from Phrase to locize, this guide walks you through exporting your files, setting up a locize project, and importing everything cleanly.


1) Export your localization files from Phrase

  1. Log in to your Phrase account.
  2. Open the project you want to migrate.
  3. Go to Locales.
  4. Download or export the translation files.
    • Recommended: Simple JSON or Nested JSON (other formats can work too).
  5. Extract the downloaded ZIP so you have the raw translation files on disk.

2) Create a locize project

  1. If you haven’t already, create an account and your first project
  2. Add the languages you need
  3. (Optional but recommended) Decide on namespaces and create them

3) Import your files into locize

You can import using any of these options:


4) Verify & go live

  • Spot-check a few keys in each language (especially plural forms and interpolation placeholders).
  • Confirm your reference language matches what your app expects.
  • If you use i18next, consider setting up a workflow that keeps locize and your repo in sync (CLI) or updates keys automatically (API).