UserLocale specifies the per-user settings used for formatting dates, times, currency, and numbers in a Windows installation.

Users can change this value on a running Windows installation, by using Regional and Language Options in Control Panel.


This setting can only be applied during the specialize and oobeSystem configuration passes. To specify language and locale settings during the windowsPE pass, see the UserLocale setting in the Microsoft-Windows-International-Core-WinPE component.

For the list of supported languages, locales, and identifiers, see Supported Language Packs and Default Settings.

If this value is configured in the oobeSystem configuration pass, the Language Selection page of Windows Welcome will be skipped.



Specifies the locale of the end user.

User_locale is a string based on the language-tagging conventions of RFC 3066. The pattern language-region is used, where language is an ISO-639 language code and region is an ISO 3166-1 country or region identifier (for example, en-US, fr-FR, or es-ES).

This value is not case sensitive.

This string type supports empty elements.

Parent Hierarchy

Microsoft-Windows-International-Core | UserLocale

Valid Passes



Applies To

For the list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-International-Core.

XML Example

The following XML output shows how to set the user locale to Japanese (Japan).


See Also