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

This setting is used during Windows Setup and Windows Deployment Services.

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


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

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


This setting is required for all unattended installations. To prevent the Windows Setup user interface (UI) from displaying, you must configure this setting. For a complete list of required settings, see Settings to Use for an Unattended Installation.



Specifies the user locale to use during Windows Setup or Windows Deployment Services.

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-WinPE | UserLocale

Valid Passes


Applies To

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

This setting is available to OEMs and system builders.

XML Example

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


See Also