The Themes setting includes settings to customize elements of the Windows visual style, including the window glass color, desktop background, and brand icon.

To customize the Windows default theme, you must include the settings: DesktopBackground and ThemeName. You may also optionally include the settings: BrandIcon, UWPAppsUseLightTheme, and WindowColor.

In addition to customizing the Windows default theme, you can also create additional custom themes using .theme files. See instructions in the MSDN topic: Creating and Installing Theme Files. Theme files can't be used as the Windows default, however, users can choose to apply one of your custom themes from their Personalization settings if desired.

Child Elements

Setting Description
BrandIcon Specifies the path to a graphic file that is incorporated in the theme preview in the user's Personalization settings.
CustomDefaultThemeFile This setting is deprecated. To customize the Windows default theme, simply define the DesktopBackground and ThemeName settings. You may also optionally include the settings: BrandIcon, ScreenSaver, UWPAppsUseLightTheme, and WindowColor. Note: While you can add additional custom themes to a Windows installation using a .theme file, .theme files can no longer be used as the default theme. Only the elements listed here can be customized in the Windows default theme.
DesktopBackground Specifies the path to a graphic file that is used for the desktop background.
ScreenSaver Specifies the path to a screen-saver file. Note: This setting is now removed. Lockscreen features and policies are preferred over using ScreenSaver. We recommend using automatic power plans to dim the screen. This can help reduce system power consumption.
ThemeName Specifies the name of the customized Windows default theme.
UWPAppsUseLightTheme Specifies whether dark mode is applied to UWP apps. By default, the classic Windows color mode (light theme) is used.
WindowColor Specifies the color of the window borders and the color of various other elements in the system, most notably colors in the Start menu, common controls, active-underline for open apps in the taskbar, and Quick Action tiles in the notification area.

Valid Configuration Passes





Parent Hierarchy

Microsoft-Windows-Shell-Setup | Themes

Applies To

For a list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Shell-Setup.

XML Example

The following XML output shows how to set a customized theme.

   <ThemeName>Fabrikam Theme</ThemeName>