Localize the information that describes your app to users

applies to both windows and phone

You can make your app more attractive to international audiences by localizing its display name, description, and other identifying features, which are described in the package manifest file.

Note Note

This topic focuses on user-facing text strings that are defined in the manifest file. For a complete discussion of how to localize your app for international audiences, see either of the following topics.

In the Manifest Designer, you can insert a token into the text box of each field that you want to localize. To localize a field, you set its value to ms-resource:TokenName, where TokenName identifies a resource in a file that’s located in a language-appropriate folder, as the following example shows:

<Properties>
<Property>
<DisplayName>ms-resource:calculator</DisplayName>
<Description>ms-resource:numbers</Description>
<Logo>tile.png</Logo>
</Property>
</Properties>

To create the resource file, open Solution Explorer, open the shortcut menu for the project name, choose Add, choose New Item, and then click Resources File.

For apps that use XAML, you localize these fields in resources.resw files by using the Resource Editor. To create the United States English version of the manifest fields, you would add an en-us\resources.resw file that contains, for example:

Name

Value

Comment

Calculator

A calculator.

Numbers

Adds numbers and displays the sum.

To add the Japanese version, you would add a ja\resources.resw file that contains, for example:

Name

Value

Comment

Calculator

Dentaku.

Numbers

Sūji o tasu to, kekka ga miemasu.

For more information about how to localize string resources, see Quickstart: Using string resources (Store apps using C#/VB/C++ and XAML) and How to load string resources (Store apps using C#/VB/C++ and XAML).

For apps that use JavaScript, you localize these fields by using JSON syntax to add strings to the resources.resjson file. To create the United States English version of the manifest fields, you would add a \strings\en-us\resources.resjson file that contains, for example:

{
"calculator": "A calculator",
"numbers": "Adds numbers and displays the sum."
}

To add the Japanese version, you would add a \strings\ja\resources.resjson file that contains, for example:

{
"calculator": "Dentaku",
"numbers": "Sūji o tasu to, kekka ga miemasu"
}

For more information about how to localize string resources, see Quickstart: Using string resources (Store apps using JavaScript and HTML) and How to load string resources (Store apps using JavaScript and HTML).

Caution noteCaution

You can reserve multiple names for an app at the Store.  When you publish a package to the Store, all values of the token string that you’ve created for the DisplayName element in the package manifest must match the names that you’ve reserved for the app at the Store. Otherwise, a validation error will appear when you upload the package to the Store.

Show:
© 2014 Microsoft. All rights reserved.