Skip to content

Using Localized Versions of WixUI

Using translated UI strings

Section titled “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

Section titled “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

Section titled “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" />