1. Help Center
  2. Setup
  3. Set up Phrase for App translation


This guide describes how to set up your first project for iOS.

iOS Phrase Setup

  1. Add a project in Phrase
  2. Up- and download language files to Phrase
  3. 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 Phrase Project

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

2. Get and configure the Phrase CLI client

To initialize the project configuration follow the instructions to set up the Phrase command-line tool. Then create a configuration with:

$ phrase init

This will guide you through the necessary steps to configure your sources and targets for your project. Make sure you select an iOS compatible format like strings or XLIFF as your language file format.

3. Up- and download language files

After you installed and configured the CLI client you’re ready to push and pull your translations:

$ phrase push
$ phrase pull

If you want to integrate Phrase directly into your build workflow you can add a new ‘run script’ build phase in your target settings of your project. In this phase you can for example just execute phrase pull to get all new translations. Be aware that the new build phase must be placed before the resources get bundled.

4. Add a new language

You can add new languages by adding a new language in the Phrase Translation Center. The language name should be chosen according to the iOS language 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 languages can be downloaded again using phrase pull with the CLI client.

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

Next steps

Working with Phrase

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

Buying professional translations

Learn how to buy professional translation service for your projects.

Further reading