Windows UI Library 2 Release Notes

The Windows UI Library (WinUI) is an open source project hosted on GitHub. All new releases are built from the Windows UI Library GitHub repo.

We encourage you to file bug reports, feature requests and community code contributions in the Windows UI Library repo.

WinUI includes two NuGet packages:

You can download and use WinUI packages in your app using the NuGet package manager: see Getting Started with the Windows UI Library for more information.


The XAML Controls Gallery sample app includes interactive demos and sample code for most WinUI features and controls.

If you have the XAML Controls Gallery app installed and updated to the latest version, see the controls in action.

If you don't have the XAML Controls Gallery app installed, get it from the Microsoft Store.

You can also view, clone, and build the XAML Controls Gallery source code from GitHub.


How-to articles for Windows UI Library controls are included with the Universal Windows Platform controls documentation.

API reference docs are located here: Windows UI Library APIs.

Version History

Version history for the main Microsoft.UI.Xaml NuGet package:

Microsoft.UI.Xaml NuGet Version Type Release date Release notes Highlights
2.7 stable September 2021 Release Notes InfoBadge, Horizontal Orientation in ColorPicker
2.6 stable June 2021 Release Notes Mica, Expander, BreadcrumbBar, ImageIcon, AnimatedIcon, PipsPager
2.5 stable December 2020 Release Notes InfoBar, Determinate ProgressRing, NavigationView FooterMenuItems
2.4 stable May 2020 Release Notes RadialGradientBrush, ProgressRing, TabView updates, Dark theme updates to TextBox family of controls, Hierarchical navigation
2.3 stable November 2019 Release Notes Progress Bar Visual Refresh, NumberBox, RadioButtons
2.2 stable August 2019 Release Notes TabView, NavigationView Updates, Visual Style Updates
2.1 stable April 2019 Release Notes First open source release from GitHub. Includes ItemsRepeater, AnimatedVisualPlayer, TeachingTip, RadioMenuFlyoutItem, CompactDensity, Shadows.
2.0 stable October 2018 Release Notes Initial release. Includes official native Fluent controls and features for Windows UWP apps.

Windows UI Library 3 Preview 4 (February 2021)

For more information on building Windows desktop and UWP apps with the latest version of WinUI 3, see Windows UI Library 3.