Click here to Skip to main content
15,568,965 members
Articles / Mobile Apps / Windows Phone 7
Posted 7 Jan 2015


46 bookmarked

Localization in Windows Universal Apps

Rate me:
Please Sign up or sign in to vote.
4.97/5 (34 votes)
7 Jan 2015CPOL12 min read
Making the App World-Ready by adapting it for a specific culture and language.


  1. Introduction

  2. Globalization

  3. Localization

  4. Implementing Localization

  5. Localizing App manifest

  6. Localizing Images

  7. Multilingual App Toolkit

  8. Pseudo Language

  9. Accessing resources from code behind



The Windows Store helps you reach a large audience. It provides support for distributing your app worldwide and takes care of all the financial intricacies. You could choose to create only an English version of your app or an app in your own language, but that would reduce your potential audience. The Windows Store serves hundreds of markets and over a hundred different languages, so ignoring them greatly reduces the audience for your app. fortunately, the Windows Runtime exposes functionality that simplifies the creation of globalized apps.

It involves two things - Globalization and Localization.


Globalization is the process of making sure that your app works well in multiple cultures. It is often confused with localization, which is the process of customizing your app for a specific language and culture Globalization refers to making your app act appropriately for different markets without any changes or customizations.


Localization refers making our app to adapt new market. To localize an app we have to remove all the hard coded strings and images and instead mark such elements with a unique identifier.

Implementing Localization

In your app, you probably use a lot of text data. When building your app, you put your text directly into your XAML and C# code. But when you want to translate your app to another language, you have to move all the strings to separate files called resource files. A resource file has the extension .resw and is placed in a special directory called Strings inside your project. This folder must contain a subfolder for every supported language. The subfolders follow the naming convention for the language/region pattern. For example, en-US means English language in the United States, and en-GB means English language in Great Britain. This pattern is called the BCP-47 language tag. You can also use just the language to force the runtime to use localized resources for every region. For example, if you use a folder named en, the English language will be used for United States as well as Great Britain (and Australia, and so on). In this subfolder, create a file called Resources.resw. This is the new naming convention for Windows Store apps. If you have an .resx file from a .NET project, copy that file into the new folder structure and rename the file extension to .resw. The format is compatible because the defined schema is same.

Here I have created a Windows Universal App which has a very simple UI. I am going to share UI for both Windows Store and Windows Phone Application. If you are new to Universal Windows App or sharing views and code for both the platforms please follow my another article Conditional Compilation in Universal Apps . If you want to implement localization only in Windows Store or Windows Phone App follow the same steps which I am doing for Universal Apps as it is almost same. So let’s get started.

Create a Windows Universal App in C#. I am selecting the blank app and naming it as Localization_Demo.


Image 1

To share the view I have dragged one of the MainPage.xaml file to shared project and then deleted it from the other two projects. Now there is a common MainPage.xaml file for both the projects. The view of project looks like this in Solution Explorer.

Image 2

Now lets us create a simple UI containing a TextBlock only.

The first thing we have to do is to remove all the hardcoded strings from the Xaml file and give that element an x:Uid. The x:Uid marking is completely independent from an element’s Name. The former is specifically for the localization process, and the latter is for the benefit of code-behind. 

Now our code looks like this

<Viewbox HorizontalAlignment="Stretch"   VerticalAlignment="Stretch" Grid.Column="1"  Grid.Row="1"  >
     <TextBlock x:Uid="message" Text="Hello" />


The next step is to create a new folder in Shared project. Name it “Strings”. In Strings folder we are going to keep all our resource file specific to each language in their specific folder. We are going to localize this app to French and our default language will be US-English. So we have to create folders for each of then. The name of folder should exactly match the language code such as fr-FR for French(France) and hi-IN for Hindi(India). We have to add as much folders as the languages we want to target and then we have to add resource file in each language specific folder which is going to contain all the translated strings.

So here in our app I have created two folders   Fr-FR for French  and en-US for US English and added  a resource file in each of them.

Image 3

To add a resource file, right click on the specific folder and select Add->New Item ->Resource File(.resw).The default name is fine, you need not to change that.

Image 4

Now open the first Resource file, here in our case it is en-US.

Here in the Name section we have to mention the x:Uid of element with the property which we want to change, it can be string, color , height , width or any other property and in the value section we have to provide its value which we want to be shown if the app runs in that specific culture.

In our demo app we are accessing the Text and color property of TextBlock whose X:uid was “message”

Image 5

Similarly we will change other resource file which is for French. Here in the value section of message.Text property we will put the translated text which will be in French.

Now if we run the app, it will run in our default language. My default language is US English, so the output view will be from en-US resource file. Also notice the foreground color of text.

Image 6

Let us change our language to French and the run the app. To do this go to Control Panel->Clock, Language, and Region -> Language

Select Add a Language and then select France. To make any selected language our default language we have to move it to top. The language here on the top of the list is automatically selected as our default language.

Image 7

Now we have changed our default language to French. Now run the app again, we have successfully localized our app to French

Image 8


Localizing App manifest

When distributing your app to multiple markets, you should localize your manifest. This enables you to show a translated description for your app in the Windows Store. You can localize several items in your manifest such as:

Display name,  Short name, and Description        

Let us localize our App’s Name and Description, for this add two categories  DisplayName and Description for Display Name of App and Description of App respectively in both the resource file with their translated values.

Image 9


Inside your manifest, use ms-resource:<identifier> to reference resource strings. For example, to set your application title, you can add a DisplayName to your resource file and reference it with ms-resource: DisplayName and for Description  reference it with ms-resource: Description. We have to set the default language also.

Make sure to do this in both the project as both project have different app manifest.

Image 10


Now this time let us run our app in Windows Phone Emulator. The default language is English-US now.


Image 11


We can change the default language from Settings-> Languages ->Add languages

Add other language which is French in our case and then restart the Emulator with French as default language.


Image 12


Notice the app name, which is now localized

Image 13



Localizing Images

You do not have to localize images if they do not contain text or other culture-specific information. Localizing images adds to the download size of your app, which can affect the user experience, so avoid image localization if possible. If you must localize images, put them in a resource-specific folder. For example, you can place one image in Images/en-US and a copy of the same file in Images/fr-FR to create both an English and a French version of your image or we can also name the images with culture specific suffix as shown in this example.


Image 14

Here we have added different images for different cultures but with a common name and language specific prefix as



But notice there in properties while selecting image source you don’t have to call the language specific image. Windows RT is smart enough to do that for you.

Similarly we can also specify different images for different resolution as the image with low resolution can look nice in tablet or mobile but it won’t look good in PC, so we must provide images with different resolution as



Here for demo I have used images with different colors so that we can easily differentiate them.

To know how your app looks at different screen sizes you can instantly view that in the Device window which you can find in Design Tab or you can also change the resolution on Simulator and Emulator at run time.

This is how our app looks with devices with low resolution.

Image 15


This is how our app looks with devices with high resolution.

Image 16


If we run the app with French as our default language on PC we get this result. Also notice the app name.

Image 17

And if we run the app with English US as default language on a low resolution device we get this result


Image 18



Multilingual App Toolkit

We could add additional folders named after language codes and manually populate translated resources with the help of a translation software. Depending on the current user’s language settings, the appropriate resources are chosen at runtime, with a fallback to the default language if no such resources exist.

However, a better option exists. The Multilingual App Toolkit, an extension to Visual Studio 2012 for Windows 8, allows you to easily localize your app by yourself, using the Machine Translation Service, or with the help of localizers. To take advantage of it, you must download and install the Multilingual App Toolkit from the Windows Dev Center. Once you do this, you can select Enable Multilingual App Toolkit from Visual Studio’s Tools menu. This automatically adds an .xlf file to a new subfolder added to your project for a test-only language called Pseudo Language.

First download and install Multilingual App Toolkit from

Restart  Visual Studio, Once you do this, you can select Enable Multilingual App Toolkit from Visual Studio’s Tools menu. This automatically adds an .xlf file to a new subfolder added to your project for a test-only language called Pseudo Language.

Image 19


I have created another Universal blank app but we have to add and enable Multilingual App Toolkit in both the projects as sharing is not available now. Now we have an .xlf file added in a new subfolder to your project . This default .xlf file is for test only pseudo language.

Here I am creating resources for Windows Store App project but we have to follow the same steps for Windows Phone also. I have created a simple UI with some TextBlock and added a default resource file with the properties that need to be localized.

Image 20

If you want to add languages, Right click on the project and select Add translation languages

Image 21


This produces a dialog box as shown

Image 22


In this dialog, Pseudo Language and our default English language is already selected, but we can scroll down and select Chinese (Traditional) [zh-Hant] from the list. After pressing OK, the MultilingualResources folder now has two .xlf files, one for Pseudo Language, and one for Traditional Chinese.

Now rebuild the  app. This populates each .xlf file with a translation for each item from the default language .resw file. Initially, each translation is just the duplicated English text. However, for some languages, such as the two we’ve chosen, you can generate machine translations based on the Microsoft Translator service! To do this for the entire file, right-click on each.xlf  file and select Generate machine translations .


Image 23

 Now we’ve got initial translations for all of our resources, which you can see by opening each .xlf file and examining the list inside the multilingual editor.

Image 24

Notice that the generated translations are automatically placed in a “Needs Review” state. And here we definitely don’t want the Blue text translated to its equivalent Chinese. This isn’t a user-visible string, and is not a valid value foreground. Instead, let’s translate it to Red, which will serve as our language specific background color. We have one more change to make. We don’t want “My English App” to be translated to Chinese, but rather “My Chinese App “so we have to correct that into the appropriate spot of the Chinese .xlf file.

Image 25

Rebuild the project and run it first with English-US as default language

Image 26

Now with Chinese as default language

Image 27


Pseudo Language

Pseudo Language is designed to test how well your app handles being localized to various (real) languages. When leveraging machine translation to Pseudo Language, you get an English-looking string whose contents are still recognizable, but designed to catch problems.

Pseudo Language strings are longer than the corresponding English strings, to help you catch cases where text might get truncated or cause issues from wrapping when you translate to a real language whose text tends to be longer than English. Each string also begins with an ID, to help you track a problematic piece of text to its original resource. It also helps you catch user-visible text in your user interface that you forgot to extract to a resource.

To test your app with Pseudo Language you have to enable it from

Control Panel-> Clock, Language, and Region -> Language.

Click Add a language. Pseudo Language is hidden, so we have to search for it

In the search box, type qps-ploc. Select English (pseudo-qps) and click Add.

And ensure that English (qps-ploc) is at the top of your preferred language list.

Now you can test you app with Pseudo language

Image 28

Image 29

Accessing resources from code behind

Sometimes we may need to access the resources from code behind. We can do this with the help of ResourceManager class which resides in Windows.ApplicationModel.Resources.Core namespace.

ResourceCandidate resource1 = ResourceManager.Current.MainResourceMap.GetValue("Resources/message/Foreground", ResourceContext.GetForCurrentView());

string foreground = resource1.ValueAsString;

Tips and Best practices

  1.  Make sure your app’s default language matches the language code for your default.resw file.
  2.  Remove the resources for Pseudo Language before uploading the App to Store.
  3. . The Multilingual App Toolkit Customer Preview incorrectly used the target culture "zh-cht" for Chinese Traditional and "zh-chs" for Chinese Simplified. This has been corrected from previous releases.To correct this error, manually modify the .xlf files that contain the incorrect codes. Change "zh-cht" to "zh-hant" and "zh-chs" to "zh-hans".



V2 of article.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
Software Developer
India India
Pooja Baraskar is an Intel Software Innovator, Microsoft MVP and a passionate Software Developer who is always willing to learn and explore new technologies. Being a programmer she always have a solution for everything as she strongly believes that nothing is impossible for a programmer. She love to work with microsoft technologies and love C# than any other thing in this world hence she is a Microsoft Certified Professional and C# specialist. She enjoys developing games rather than playing. She has developed many apps and games for Windows Store and Tizen Store. Her current interest is Internet of Things, hence won Microsoft Internet of Things competition and has been awarded at Azure Conference 2015 Pune also all her articles at CodeProject are prize winning. She also writes about IoT on C# corner. Recently she has been awarded as the Most Valuable Blogger by DZone.

She is from a small town of India hence a self learner. She believes doing things in the most simpler manner as it can be and now she is sharing her knowledge with various programming communities and motivating aspiring developers.

You can also reach her at her personal blog and facebook

*Microsoft MVP
*Intel Software Innovator
*Won Microsoft Internet of Things competition 2015
*DZone Most Valuable Blogger
*C# Corner MVP

Comments and Discussions

QuestionI don't want to use x:Uid Pin
darkbaron191215-Oct-15 22:54
darkbaron191215-Oct-15 22:54 
Questiongood job pooja Pin
Mansoor Alikhan K1-Jul-15 23:23
Mansoor Alikhan K1-Jul-15 23:23 
AnswerRe: good job pooja Pin
Pooja Baraskar23-Aug-15 14:59
professionalPooja Baraskar23-Aug-15 14:59 
GeneralExcellent Pin
Gaurav Aroraa8-Apr-15 6:22
professionalGaurav Aroraa8-Apr-15 6:22 
GeneralRe: Excellent Pin
Pooja Baraskar9-Apr-15 4:41
professionalPooja Baraskar9-Apr-15 4:41 
QuestionDoes MAT support for MVC projects, if so please suggest how to use this Pin
Member 15049451-Mar-15 9:46
Member 15049451-Mar-15 9:46 
Generalvery nice Pin
BillW3317-Feb-15 6:07
professionalBillW3317-Feb-15 6:07 
GeneralRe: very nice Pin
Pooja Baraskar17-Feb-15 6:16
professionalPooja Baraskar17-Feb-15 6:16 
SuggestionExcellent Pin
Giannakakis Kostas15-Feb-15 22:38
professionalGiannakakis Kostas15-Feb-15 22:38 
GeneralRe: Excellent Pin
Pooja Baraskar16-Feb-15 5:01
professionalPooja Baraskar16-Feb-15 5:01 
GeneralRe: Excellent Pin
Pooja Baraskar19-Feb-15 9:00
professionalPooja Baraskar19-Feb-15 9:00 
GeneralRe: Excellent Pin
Giannakakis Kostas19-Feb-15 21:03
professionalGiannakakis Kostas19-Feb-15 21:03 
GeneralRe: Excellent Pin
Pooja Baraskar20-Feb-15 4:29
professionalPooja Baraskar20-Feb-15 4:29 
GeneralMy vote of 5 Pin
Renju Vinod15-Feb-15 18:20
professionalRenju Vinod15-Feb-15 18:20 
GeneralRe: My vote of 5 Pin
Pooja Baraskar16-Feb-15 4:50
professionalPooja Baraskar16-Feb-15 4:50 
QuestionMy vote of 5 Pin
Liju Sankar9-Feb-15 1:54
professionalLiju Sankar9-Feb-15 1:54 
GeneralRe: My vote of 5 Pin
Pooja Baraskar9-Feb-15 4:14
professionalPooja Baraskar9-Feb-15 4:14 
GeneralMy vote of 5 Pin
Humayun Kabir Mamun8-Jan-15 2:16
Humayun Kabir Mamun8-Jan-15 2:16 
GeneralRe: My vote of 5 Pin
Pooja Baraskar8-Jan-15 3:14
professionalPooja Baraskar8-Jan-15 3:14 
GeneralMy vote of 5 Pin
Gustav Brock8-Jan-15 0:25
professionalGustav Brock8-Jan-15 0:25 
GeneralRe: My vote of 5 Pin
Pooja Baraskar8-Jan-15 3:16
professionalPooja Baraskar8-Jan-15 3:16 
GeneralMy vote of 5 Pin
Abhishek Nandy7-Jan-15 22:24
professionalAbhishek Nandy7-Jan-15 22:24 
GeneralRe: My vote of 5 Pin
Pooja Baraskar7-Jan-15 22:32
professionalPooja Baraskar7-Jan-15 22:32 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.