Windows UI Library 2 Release Notes

The Windows UI Library (WinUI) is hosted on GitHub where we encourage you to file bug reports, feature requests and community code contributions.

WinUI includes two NuGet packages:

• Microsoft.UI.Xaml: Controls and Fluent Design for UWP apps. This is the main WinUI package.

• Microsoft.UI.Xaml.Core.Direct: Low-level APIs for use in middleware components.

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.

Examples

Tip

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).

Documentation

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.