Migrate from WebTranslateIt to PhraseApp

PhraseApp is the alternative to WebTranslateIt. If you want to migrate your data from WebTranslateIt to PhraseApp, this following guide will help you with the process and explain some major differences between the two systems.



PhraseApp is the advanced translation management platform:

  • The powerful In-Context-Editor for your translations
  • Multi-Format support (e.g. for YAML, Gettext, XLIFF, iOS Strings or Android XML)
  • Commenting, Tagging and a fast and flexible search
  • A full API to all resources
  • Multi-User support with customizable privileges
  • Screenshot upload and description annotations for keys

Migrating from WebTranslateIt to PhraseApp


If you’re looking for an alternative to WebTranslateIt we’re happy to support you with our migration guide. Migrating to PhraseApp is easy:

1. Download your locale files


Since you most likely want to use your latest translations with PhraseApp, you will first need to download your translations from WebTranslateIt:

$ wti pull --all

This will dump the latest version of your translations from WebTranslateIt.

2. Sign up and create a project


If you haven’t done already, you should create your free trial account and use our Getting Started Wizard to create your first project.

3. Install the command line client


Download the command line tool and initialize your PhraseApp project:

$ phraseapp init

This will create a .phraseapp.yml config file in your project.

4. Uploading locale files


Upload your files by executing the push command:

$ phraseapp push

After uploading all locales, they are available within your PhraseApp Translation Center.

5. Downloading locale files


After you have translated all of the strings in a new locale or updated some text, you will probably want to download them in order to deploy them to your production system. This can be done with the pull command:

$ phraseapp pull

You can now add the new localization files to your source control and deploy them to production.

6. Advanced use


Explaining all of the advanced features of PhraseApp would certainly go beyond the scope of this guide. We strongly recommend our guides to learn all about the powerful features and how you can use them with your translation workflow.

7. Cleanup


You can now remove WebTranslateIt from your application. To remove WebTranslateIt, just:

  • Remove the gem WebTranslateIt gem from your app
  • Remove Github hooks for WebTranslateIt (if any)

Major differences between WebTranslateIt and PhraseApp


There are many important differences in the way the systems handle the translation update workflow:

WebTranslateIt PhraseApp
Translation Structure File-based Key-based PhraseApp does not think of translations as content of a file, but instead lets you organize your translations with tags and projects - a much more natural way of structuring translations that gives you more flexibility to use your data in other platforms
Uploading translations wti push phraseapp push PhraseApp will never perform destructive actions, while WebTranslateIt will try to merge your locale data (which can cause a lot of conflicts and even result in losing translations)
Downloading translations wti pull phraseapp pull PhraseApp will always give you the exact state as you find it in your Translation Center instead of trying to merge your localization files
Feature-based translations - phraseapp ... --tag=myfeature PhraseApp allows you to push new translations and assign them to tags so you can translate them grouped by features