iOS PhraseApp Setup


This guide describes how to set up your first project as well how to install and configure the PhraseApp Xcode Plugin.


  1. Add project in PhraseApp
  2. Install and configure PhraseApp Xcode plugin
  3. Up- and download locale files to PhraseApp
  4. Add a new language

If you’re a novice in iOS localization best practices, check out our blog post on the topic: How To Translate Apps In Xcode - a step-by-step tutorial that gets you started.

1. Set up PhraseApp Project

Sign in to the PhraseApp Translation Center and add a project, choose “XLIFF (.xlf)” as your main format.

2. Get and configure the PhraseApp plugin for Xcode

Xcode is the official IDE for iOS application development. The PhraseApp Xcode plugin connects them both, with good support for the workflow proposed by Apple regarding localization of applications. For further details on installation and configuration see the plugin’s Github page.

3. Up- and download locale files

After you installed and configured the plugin you’re ready to actually pull and push locale files from and to PhraseApp.

The Window > PhraseApp menu item will open the PhraseApp plugin window. It maintains a list of open workspaces and allows to push and pull the respective workspace’s locale files. The details can be found on the plugin’s Github page, too.

4. Add a new language

You can add new languages by adding a new locale in the PhraseApp Translation Center. The locale name should be chosen according to the iOS locale name constant convention (see Language and Locale IDs, for languages without variants a simple two-letter notation is used e.g. “en” for English. For language variants, such as British English, you need to specify the country in the name as well, e.g. “en-GB”.

The translated locales can be downloaded again using the Xcode plugin.

If you have a locale file for an additional language, you can import those translations using the file upload in the Translation Center.

Next steps

Working with PhraseApp

Learn how to work efficiently with PhraseApp in our Getting Started guide.

Buying professional translations

Learn how to buy professional translation service for your projects.

Further reading