Pseudo-Localization
Pseudo-localization is a method for testing internationalization aspects of your application during the early stages of development, before you begin translation into different languages. It generates fake translations that take up the same amount of space and use similar character sets, and highlights issues that might occur when you apply real translation to the content of your application.
Pseudo-localization can help flag potential problem areas, such as:
- Limited space: Areas where there might not be enough space for translated text, causing it to wrap awkwardly or truncate.
- Non-localized strings: Strings that are hard-coded and do not go through the localization framework.
- Combining separately translated sentences or paragraphs that are built in a way that is difficult to localize.
- Font encoding and conversion issues: Ensure fonts support all the necessary special characters for each language and that the glyphs for such special characters don't have any design issues.
- Right-to-left text issues: A user interface in a right-to-left (RTL) language needs to be laid out in a mirror image of a left-to-right layout.
- Non-localized art, such as textures that contain text.
Example
A typical use for pseudo-localization is to find potential issues in the content of a menu. For example, the following image displays a menu with the original English text:

The following image displays the same menu, but with pseudo-localization applied to the text to expand the amount of space the text needs, and replace some characters with others.

The pseudo-localization shows that the final menu item Exit Game is likely to overlap its space if it is translated into a language that requires more space. If a pseudo-translation does not fit, then it is likely that some real translations don’t fit.
The following image displays the same menu, but with the text translated into Spanish.

The final menu item does indeed grow in size as indicated by the pseudo-localization, and requires manual adjustment to fit it into the UI. A solution in this case might be to change Exit Game to Quit, which is likely to require less space when translated to other languages.
Further Reading
- W3: Text size in translation
- Game Developer: Pseudo-Localization A Must in Video Gaming
- Minimizing Human Error in Localization
- Pseudolocalization to Catch i18n Errors Early
Pseudo-Locale Assets
A Pseudo-Locale Asset pulls a value from a String Table and applies pseudo-localization to it on demand. To use Pseudo-Localization, you need to do the following:
- Set up your text in String Tables
- Set up a Pseudo-Locale Asset
- Apply it to your Scene at runtime
Set up a Pseudo-Locale Asset
To create a new Pseudo-Locale Asset, go to Assets > Create > Localization > Pseudo-Locale.

A Pseudo-Locale is a type of Locale, so most of its properties are the standard Locale properties. Instead of a Locale Code, Pseudo-Locales have a Source Locale field. The Pseudo-Locale uses the code of whichever Locale you assign to it.
| Property | Description |
|---|---|
| Locale Name | The name of the Locale, used when presenting it to the user. See Locale. |
| Source Locale | The locale you want to use for pseudo-localization. For example, if you choose English, the Pseudo-Localization system loads the strings from the English String Table, and then pseudo-localizes them. Choosing a Locale here also sets this asset’s own code, so the Culture Info and formatting properties below reflect it. |
| Culture Info | The Culture Info match found for this Locale’s code. See Locale. |
| Use Custom Formatter | Enable this to format region specific values with a culture other than the one this Locale’s code provides. See Locale. |
| Custom Formatter Code | The code to format region specific values with. This is only editable when you enable Use Custom Formatter. See Locale. |
| Formatting Culture Info | The culture used to format region specific values, with a read-only Currency, Date/Time and Number example of its output. |
| Sort Order | Use the sort order to override where this Pseudo-Locale appears when Locales are sorted in a list. See Locale. |
| Metadata | Use the Metadata list to attach additional Metadata to this Pseudo-Locale, such as a Comment or a Fallback Locale. The list offers every metadata type the project allows for a Locale. |
| Pseudo-Localization Methods | Use the Methods list to define which methods of pseudo-localization this Pseudo-Locale Asset should apply to your application’s text. By default, the Pseudo-Locale includes the Preserve Tags, Expander, Accenter, and Encapsulator Methods. See Methods for a full description of each Method. |
| Pseudo-Localization Preview | This displays a preview of the pseudo-localization settings you have configured. You can edit the text field to see a preview of any text string. |
Apply it to your Scene at runtime
To apply a Pseudo-Locale, the Selected Locale should be changed to the new Pseudo-Locale asset. This can be done in the Editor through the Locale Game View Menu or through Script by changing the LocalizationSettings.SelectedLocale. The package Samples, which can be found in the Package Manager, contain examples of changing the Locale and example Locale Selection menus.