Click here to Skip to main content
12,828,403 members (46,639 online)
Click here to Skip to main content
Add your own
alternative version


15 bookmarked
Posted 20 Jul 2006

Localizability Testing

, 28 Jul 2006 CPOL
Rate this:
Please Sign up or sign in to vote.
Localizability Testing Guide


Localizability testing is the first step in the software localization process. It verifies that the user interface of the program being tested can be easily translated to any target language without re-engineering or making code modifications. Localizability testing is of extreme importance because missed errors might cause significant problems in the successive stages. Since localizability bugs have to be fixed in the application source code, they must be looked for at the earliest stage of development possible. By doing so, you can avoid having to fix bugs for every language version at a later point.

Localizability Testing

During localizability testing, you should check that your software meets the following requirements:

Resources are separated from the code

All resources, that should be translated, must be separated from the code. By doing so, you can avoid having to send your source code to translator.

Only locale-sensitive functions

All text manipulations and parsing - such as finding string length, locating substrings, changing text case, and so on - have to be done using locale-sensitive and encoding-sensitive library routines. Most ANSI centric routines work incorrectly with Asian languages.

No string concatenations

Strings are not calculated at run time by stripping or concatenation, because it is impossible to translate the whole phrase. String substitution has to be done via language-aware APIs such as FormatMessage or _stprintf.

No assumptions about string length

Do not make assumptions about string buffer length if it is loaded from resources. For example, you should not use fixed length buffer of 10 characters for month name, just because the longest month name in English "September" takes 9 characters. Since English is one of the most compact languages, translation is likely to increase this length, so the localized name might not fit into the buffer.

Careful runtime positioning

Avoid where possible positioning user interface controls at a run time, because localized application may use different fonts and display other content. All layout algorithms should be carefully checked.

No assumptions exist on drive and folder names

The names of the system folders are usually translated; the same can apply to the names of other objects defined by the operating system and applications your code interacts with. Folder names, names of built-in accounts, and other localizable elements of the operating system can and should be queried at run time using Windows API functions such as SHGetFolderPath.

How to Test

Code Review

There are two ways to ensure localizability requirements. The first is to review all source code. It can be done only by a highly qualified professional who reviews all the code and checks that every string operation and constant meets localizability requirements.


Another way is to test the application after pseudo-localizing its interface. Pseudo-localization is the most effective way to find localizability problems before translation of the program's UI is started. Pseudo-localization gives you a translation without the cost of an actual localization. This approach doesn't require any profound technical or localization skills and thus it can be done by an average tester.

The common pseudo-translation techniques are:

  • Replace English characters with accented one: a -> å, c -> ç, n -> ñ, etc. This will keep the text readable, and non-modified text will catch your attention.
  • Replace English characters with Asian symbols. This will help you to test how your application deals with two-byte characters, encoding and locale. This will make finding places where the program utilizes ANSI functions to process or display text.
  • Add extra characters to your resource strings. In many cases, translated text is longer then the English original the length will also increase. English is one of the most compact languages: what is usually depicted as “OK”  in English becomes “Aceptado” in Spanish, for example.
  • Mark the beginning and the end of each resource string. Having those markers, you'll easily see when text is built at run-time – potential source of localizability bugs. (Some text -> #Some text$).

Once you pseudo-localize your program, test its functionality. Pseudo–localized applications should function no differently than its original US version, but thanks to readability of pseudo-localized text, it is very easy to recognize potential problems.

Automatic Pseudo-Translation

The easiest way to perform pseudo-localization is to modify the program’s resources automatically. There are several tools that simplify this process. One of them is pseudoLocalizer ( – a free tool that pseudo-translates input text. The major drawback is that if you use pseudoLocalizer with Visual Studio projects (MFC/.NET), you have to manually replace text in every resource element. It takes a lot of time and patience to do so.

Another option is to use software localization tool such as Lingobit Localizer ( Lingobit Localizer automatically extracts all resources from application executable file and pseudo-localizes all the strings. Then Lingobit creates pseudo-localized application for you to test. Even though Lingobit Localizer is commercial, you do not need to buy it to do localizability testing – trial limitations do not affect pseudo-localization features.

Points of Interest

  1. Lingobit Localizer
  2. pseudoLocalizer
  3. Globalization Step-by-Step
  4. Testing for World-Readiness
  5. Library for MFC applications localization using resource-only DLLs


  • 2006-07-28 Updated version
  • 2006-07-21 First version


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


About the Author

Web Developer
Russian Federation Russian Federation
I am a senior software developer at Lingobit Technologies, leading provider of software for localization industry.

You may also be interested in...


Comments and Discussions

GeneralTough Crowd Pin
wildbongos1-Aug-06 6:18
memberwildbongos1-Aug-06 6:18 
Yes, it's obviously an ad, but there was *some* interesting information presented that could be useful if one did a search for 'localization'.
GeneralUngrounded assertions Pin
rm82225-Jul-06 5:24
memberrm82225-Jul-06 5:24 
GeneralRe: Ungrounded assertions Pin
flyingxu1-Aug-06 19:32
memberflyingxu1-Aug-06 19:32 
GeneralNo advertising please Pin
mschee24-Jul-06 22:58
membermschee24-Jul-06 22:58 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.170326.1 | Last Updated 28 Jul 2006
Article Copyright 2006 by smm200
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid