Using Localized Versions of WixUI

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:

Language Location Culture code WXL file
Arabic Saudi Arabia ar-SA WixUI_ar-SA.wxl
Bulgarian Bulgaria bg-BG WixUI_bg-BG.wxl
Catalan Spain ca-ES WixUI_ca-ES.wxl
Croatian Croatia hr-HR WixUI_hr-HR.wxl
Czech Czech Republic cs-CZ WixUI_cs-CZ.wxl
Danish Denmark da-DK WixUI_da-DK.wxl
Dutch Netherlands nl-NL WixUI_nl-NL.wxl
English United States en-US WixUI_en-US.wxl
Estonian Estonia et-EE WixUI_et-EE.wxl
Finnish Finland fi-FI WixUI_fi-FI.wxl
French France fr-FR WixUI_fr-FR.wxl
German Germany de-DE WixUI_de-DE.wxl
Greek Greece el-GR WixUI_el-GR.wxl
Hebrew Israel he-IL WixUI_he-IL.wxl
Hindi India hi-IN WixUI_hi-IN.wxl
Hungarian Hungary hu-HU WixUI_hu-HU.wxl
Italian Italy it-IT WixUI_it-IT.wxl
Japanese Japan ja-JP WixUI_ja-JP.wxl
Kazakh Kazakhstan kk-KZ WixUI_kk-KZ.wxl
Korean Korea ko-KR WixUI_ko-KR.wxl
Latvian Latvia lv-LV WixUI_lv-LV.wxl
Lithuanian Lithuania lt-LT WixUI_lt-LT.wxl
Norwegian (Bokmål) Norway nb-NO WixUI_nb-NO.wxl
Polish Poland pl-PL WixUI_pl-PL.wxl
Portuguese Brazil pt-BR WixUI_pt-BR.wxl
Portuguese Portugal pt-PT WixUI_pt-PT.wxl
Romanian Romania ro-RO WixUI_ro-RO.wxl
Russian Russia ru-RU WixUI_ru-RU.wxl
Serbian (Latin) Serbia and Montenegro sr-Latn-CS WixUI_sr-Latn-CS.wxl
Simplified Chinese China zh-CN WixUI_zh-CN.wxl
Slovak Slovak Republic sk-SK WixUI_sk-SK.wxl
Slovenian Solvenia sl-SI WixUI_sl_SI.wxl
Spanish Spain es-ES WixUI_es-ES.wxl
Swedish Sweden sv-SE WixUI_sv-SE.wxl
Thai Thailand th-TH WixUI_th-TH.wxl
Traditional Chinese Hong Kong SAR zh-HK WixUI_zh-HK.wxl
Traditional Chinese Taiwan zh-TW WixUI_zh-TW.wxl
Turkish Turkey tr-TR WixUI_tr-TR.wxl
Ukrainian Ukraine uk-UA WixUI_uk-UA.wxl

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" />