Windows UI Library 2 Release Notes

The Windows UI Library (WinUI) is hosted on GitHub.

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.



For more info, design guidance, and code examples, see Design and code Windows apps.

The WinUI 2 Gallery app includes interactive examples of most WinUI 2 controls, features, and functionality.

If the gallery app is installed already, click WinUI 2 Gallery to open it.

If not installed, download the WinUI 2 Gallery from the Microsoft Store.

You can also get the source code from GitHub (select the winui2 branch).


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.8 stable July 2022 Release Notes WebView2
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.