How Oobe.xml Works

Windows Welcome, Welcome Center, and ISP sign-up opportunities that consume content from Oobe.xml will check for and will load Oobe.xml in the following locations, in the following order:

  1. %WINDIR%\System32\Oobe\Info\Oobe.xml
  2. %WINDIR%\System32\Oobe\Info\Default\<language>\Oobe.xml
  3. %WINDIR%\System32\Oobe\Info\<country>\<language>\Oobe.xml

Single Language Deployments

If you are delivering computers to one country or region, in a single language, you should use a single Oobe.xml file in \%WINDIR%\System32\Oobe\Info.

This file can contain all your customizations to Windows Welcome, Welcome Center, and ISP Signup.

For example, an English version of Windows Vista® that is delivered to the United States can have the following directory structure.

\%WINDIR%\system32\oobe\info\oobe.xml

If you are delivering computers to more than one country or region, in a single language, and you plan to vary your customizations from country or region to country or region, place an Oobe.xml file in \%WINDIR%\System32\Oobe\Info.

This file can contain your logo, as well as the default regional settings that you plan to present to the user. You should also include a default set of customizations in this Oobe.xml file, in case the user selects a country or a region for which you have not made specific customizations. This Oobe.xml should also contain the <eulafilename> node with the name of the customized EULA that you intend to use.

Place an Oobe.xml file for each country or region that contains unique customized content into \%WINDIR%\System32\<country or region that you are deploying to>\<language you are deploying in>. Once the user has chosen a country or a region, this file will be used to display branded content, offers, and additional customizations.

For example, an English version of Windows Vista delivered to the United States and to Canada can have the following directory structure.

\%WINDIR%\system32\oobe\info\oobe.xml (logo, EULA file name, and regional settings)

\%WINDIR%\system32\oobe\info\244\1033\oobe.xml (United States custom content)

\%WINDIR%\system32\oobe\info\39\1033\oobe.xml (Canada custom content)

Multiple Language or Region Deployments

If you are delivering computers to one or more countries or regions and are delivering computers running Windows Vista with additional language packs, place an Oobe.xml file in \%WINDIR%\System32\Oobe\Info. This can contain your logo, as well as the default regional settings that you plan to present to the user. You should also include a default set of customizations in this Oobe.xml file, in case the user selects a country or a region for which you have not made specific customizations. This Oobe.xml should also contain the <eulafilename> node with the name of the custom EULA that you intend to use.

Place an Oobe.xml file for each country or region that contains unique customized content into \%WINDIR%\System32\<country or region that you are deploying to>\<language that you are deploying in>. Once the user has chosen a country or a region, this file will be used to display your branded content, offers, and additional customizations.

For example, an English version of Windows Vista that is delivered to the United States and to Canada would use the following directory structure.

\%WINDIR %\system32\oobe\info\oobe.xml (logo, EULA file name, and regional settings)

\%WINDIR %\system32\oobe\info\244\1033\oobe.xml (United States custom content)

\%WINDIR %\system32\oobe\info\39\1033\oobe.xml (Canada custom content)

If you are delivering computers to one or more countries or regions and are delivering computers running Windows Vista with additional language packs, place an Oobe.xml file in \%WINDIR%\System32\Oobe\Info. The logo that is specified in this file will be displayed on the first (language selection) page in Windows Welcome. This Oobe.xml file should also contain the <eulafilename> node with the name of the customized EULA that you intend to use.

Place an Oobe.xml for each Windows language that you are including into \%WINDIR%\System32\Default\<language you are deploying>. This should contain the default regional settings that you plan to present for a given language, as well as a default set of customizations in this Oobe.xml file, in case the user selects a country or a region for which you have not made specific customizations.

Place an Oobe.xml file for each country or region that contains unique customized content into \%WINDIR%\System32\<country or region that you are deploying to>\<language that you are deploying in>. Once the user has chosen a country or a region, this file will be used to display your branded content, offers, and additional customizations.

For example, a version of Windows Vista with English and French language packs that is delivered to the United States and Canada would use the following directory structure.

  • Logo and EULA
    \%WINDIR%\system32\oobe\info\oobe.xml (logo and EULA file name)
  • Regional settings and fallback (non-country-specific localized content)
    \%WINDIR%\system32\oobe\info\default\1033\oobe.xml (default regional settings and English content if the user chooses something other than the United States or Canada)
    \%WINDIR%\system32\oobe\info\default\1036\oobe.xml (default regional settings and French content if the user chooses something other than United States or Canada)
  • Country- or region-specific content in the appropriate languages
    \%WINDIR%\system32\oobe\info\244\1033\oobe.xml (United States custom content in English)
    \%WINDIR%\system32\oobe\info\244\1036\oobe.xml (United States custom content in French)
    \%WINDIR%\system32\oobe\info\39\1033\oobe.xml (Canada custom content in English)
    \%WINDIR%\system32\oobe\info\39\1036\oobe.xml (Canada custom content in French)

Country folder format

The country folders must be named based on the decimal version of the GeoID of the country. For example, to create a "Canada" folder, name the folder "39".

For a complete list of GeoIDs, see the MSDN Web site.

Note

These values are provided in hexadecimal format and must be converted to decimal format to be used in the folder structure.

Language folder format

The name of the language folders must be based on the decimal version of the LCID value for the given language. For example, to create an "English" folder, name the folder "1033."

There are many more LCIDs than languages. A few LCIDs correlate to the languages that can be released with Windows Vista. For more information about which languages release with Windows Vista, at what level of localization, and their decimal identifiers, see Supported Language Packs and Default Settings.

See Also

Concepts

What is Oobe.xml?
Oobe.xml Technical Reference