WiX Toolset

Using Localized Versions of WixUI

Using translated UI strings

WixUIExtension includes a set of WiX localization (.wxl) files that contain translated UI text, error and progress text strings for several languages. To specify a UI language for your installer, pass the desired culture value on the command line when calling light. For example:

light -ext WixUIExtension -cultures:fr-FR Product.wixobj -out Product.msi

WixUIExtension includes translated strings for the following languages:

<td><b>Location</b></td>

<td><b>Culture code</b></td>

<td><b>WXL file</b></td>
<td>Saudi Arabia</td>

<td>ar-SA</td>

<td>WixUI_ar-SA.wxl</td>
<td>Bulgaria</td>

<td>bg-BG</td>

<td>WixUI_bg-BG.wxl</td>
<td>Spain</td>

<td>ca-ES</td>

<td>WixUI_ca-ES.wxl</td>
<td>Croatia</td>

<td>hr-HR</td>

<td>WixUI_hr-HR.wxl</td>
<td>Czech Republic</td>

<td>cs-CZ</td>

<td>WixUI_cs-CZ.wxl</td>
<td>Denmark</td>

<td>da-DK</td>

<td>WixUI_da-DK.wxl</td>
<td>Netherlands</td>

<td>nl-NL</td>

<td>WixUI_nl-NL.wxl</td>
<td>United States</td>

<td>en-US</td>

<td>WixUI_en-US.wxl</td>
<td>Estonia</td>

<td>et-EE</td>

<td>WixUI_et-EE.wxl</td>
<td>Finland</td>

<td>fi-FI</td>

<td>WixUI_fi-FI.wxl</td>
<td>France</td>

<td>fr-FR</td>

<td>WixUI_fr-FR.wxl</td>
<td>Germany</td>

<td>de-DE</td>

<td>WixUI_de-DE.wxl</td>
<td>Greece</td>

<td>el-GR</td>

<td>WixUI_el-GR.wxl</td>
<td>Israel</td>

<td>he-IL</td>

<td>WixUI_he-IL.wxl</td>
<td>India</td>

<td>hi-IN</td>

<td>WixUI_hi-IN.wxl</td>
<td>Hungary</td>

<td>hu-HU</td>

<td>WixUI_hu-HU.wxl</td>
<td>Italy</td>

<td>it-IT</td>

<td>WixUI_it-IT.wxl</td>
<td>Japan</td>

<td>ja-JP</td>

<td>WixUI_ja-JP.wxl</td>
<td>Kazakhstan</td>

<td>kk-KZ</td>

<td>WixUI_kk-KZ.wxl</td>
<td>Korea</td>

<td>ko-KR</td>

<td>WixUI_ko-KR.wxl</td>
<td>Latvia</td>

<td>lv-LV</td>

<td>WixUI_lv-LV.wxl</td>
<td>Lithuania</td>

<td>lt-LT</td>

<td>WixUI_lt-LT.wxl</td>
<td>Norway</td>

<td>nb-NO</td>

<td>WixUI_nb-NO.wxl</td>
<td>Poland</td>

<td>pl-PL</td>

<td>WixUI_pl-PL.wxl</td>
<td>Brazil</td>

<td>pt-BR</td>

<td>WixUI_pt-BR.wxl</td>
<td>Portugal</td>

<td>pt-PT</td>

<td>WixUI_pt-PT.wxl</td>
<td>Romania</td>

<td>ro-RO</td>

<td>WixUI_ro-RO.wxl</td>
<td>Russia</td>

<td>ru-RU</td>

<td>WixUI_ru-RU.wxl</td>
<td>Serbia and Montenegro</td>

<td>sr-Latn-CS</td>

<td>WixUI_sr-Latn-CS.wxl</td>
<td>China</td>

<td>zh-CN</td>

<td>WixUI_zh-CN.wxl</td>
<td>Slovak Republic</td>

<td>sk-SK</td>

<td>WixUI_sk-SK.wxl</td>
<td>Solvenia</td>

<td>sl-SI</td>

<td>WixUI_sl_SI.wxl</td>
<td>Spain</td>

<td>es-ES</td>

<td>WixUI_es-ES.wxl</td>
<td>Sweden</td>

<td>sv-SE</td>

<td>WixUI_sv-SE.wxl</td>
<td>Thailand</td>

<td>th-TH</td>

<td>WixUI_th-TH.wxl</td>
<td>Hong Kong SAR</td>

<td>zh-HK</td>

<td>WixUI_zh-HK.wxl</td>
<td>Taiwan</td>

<td>zh-TW</td>

<td>WixUI_zh-TW.wxl</td>
<td>Turkey</td>

<td>tr-TR</td>

<td>WixUI_tr-TR.wxl</td>
<td>Ukraine</td>

<td>uk-UA</td>

<td>WixUI_uk-UA.wxl</td>
Language
Arabic
Bulgarian
Catalan
Croatian
Czech
Danish
Dutch
English
Estonian
Finnish
French
German
Greek
Hebrew
Hindi
Hungarian
Italian
Japanese
Kazakh
Korean
Latvian
Lithuanian
Norwegian (Bokmål)
Polish
Portuguese
Portuguese
Romanian
Russian
Serbian (Latin)
Simplified Chinese
Slovak
Slovenian
Spanish
Swedish
Thai
Traditional Chinese
Traditional Chinese
Turkish
Ukrainian

Creating multiple setups with different setup UI languages

You can create a series of .msi files that each use different setup UI languages by calling candle once and then calling light multiple times with different culture values. For example:

candle Product.wxs
light -ext WixUIExtension -cultures:en-us Product.wixobj -out Product_en-us.msi
light -ext WixUIExtension -cultures:fr-fr Product.wixobj -out Product_fr-fr.msi
light -ext WixUIExtension -cultures:de-de Product.wixobj -out Product_de-de.msi
light -ext WixUIExtension -cultures:it-it Product.wixobj -out Product_it-it.msi
light -ext WixUIExtension -cultures:ja-jp Product.wixobj -out Product_ja-jp.msi
light -ext WixUIExtension -cultures:pl-pl Product.wixobj -out Product_pl-pl.msi
light -ext WixUIExtension -cultures:ru-ru Product.wixobj -out Product_ru-ru.msi
light -ext WixUIExtension -cultures:es-es Product.wixobj -out Product_es-es.msi

Using translated error and progress text

By default, WixUI will not include any translated Error or ProgressText elements. You can include them by referencing the WixUI_ErrorProgressText UI element:

<UIRef Id="WixUI_ErrorProgressText" />