Using Localized Versions of WixUI

Windows Installer XML

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 name Culture code WXL file name
English en-us WixUI_en-us.wxl
French fr-fr WixUI_fr-fr.wxl
German de-de WixUI_de-de.wxl
Italian it-it WixUI_it-it.wxl
Japanese ja-jp WixUI_ja-jp.wxl
Polish pl-pl WixUI_pl-pl.wxl
Russian ru-ru WixUI_ru-ru.wxl
Spanish es-es WixUI_es-es.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" />