Windows Phone PhraseApp Setup


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


  1. Add Project in PhraseApp
  2. Download PhraseApp Visual Studio plugin
  3. Set Project ID and Access Token in plugin settings
  4. Upload your locale files
  5. Add a new language

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

Note: this guide targets Windows Phone 8.1 apps, however, the same steps are applicable for Windows Grid and Hub apps (“Metro”), as well as Windows Universal Platform apps.

1. Set up PhraseApp Project

Sign in to the PhraseApp Translation Center and add a project, choose “Windows 8 Resource” as your main format.

2. Get and configure the PhraseApp plugin for Visual Studio

Visual Studio is the official IDE for Windows application development. We offer a plugin that connects VisualStudio and PhraseApp.

Go to the Tools > Extensions and Updates menu. In the Online > Visual Studio Gallery search for “PhraseApp” and download (and thereby install) it.

After installation the CLI client path must be configured in Tools > Options > PhraseApp. Give the full path, like for example C:\path\to\phraseapp.exe.

Additionally your project must have a PhraseApp configuration file named .phraseapp.yml in its root directory. This file can be generated using the CLI tool. For additional configuration options see the PhraseApp client configuration 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. In the “Tools” menu, you can find PhraseApp commands that trigger those actions according to your configuration file. The output of both operations will be sent to the Output toolwindow, that can be opened via View > Output, if not visible already.

4. Add a new language

You can add new languages by either creating a new locale file in your Windows Phone application and uploading the files using the PhraseApp plugin or by adding a new Locale in the PhraseApp Translation Center.

The locale name should be chosen according to the Windows Phone locale name constant convention (see MSDN Locales and Languages, e.g. “en-US” or “de-DE”.

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