Avalonia.Controls.WebView 12.0.0-preview1

Prefix Reserved
This is a prerelease version of Avalonia.Controls.WebView.
dotnet add package Avalonia.Controls.WebView --version 12.0.0-preview1
                    
NuGet\Install-Package Avalonia.Controls.WebView -Version 12.0.0-preview1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Avalonia.Controls.WebView" Version="12.0.0-preview1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Avalonia.Controls.WebView" Version="12.0.0-preview1" />
                    
Directory.Packages.props
<PackageReference Include="Avalonia.Controls.WebView" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Avalonia.Controls.WebView --version 12.0.0-preview1
                    
#r "nuget: Avalonia.Controls.WebView, 12.0.0-preview1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Avalonia.Controls.WebView@12.0.0-preview1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Avalonia.Controls.WebView&version=12.0.0-preview1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Avalonia.Controls.WebView&version=12.0.0-preview1&prerelease
                    
Install as a Cake Tool

Avalonia WebView

The Avalonia WebView component provides native web browser functionality for your Avalonia applications. Unlike embedded WebView solutions that require bundling Chromium, this implementation leverages the platform's native web rendering capabilities, resulting in smaller application size and better performance.

Requirements

This package requires Avalonia Accelerate license: https://avaloniaui.net/accelerate

Features

  • Platform-Native Engines: WebView2 (Windows), WebKit (macOS), WebKitGTK (Linux)
  • Lightweight: No embedded browser engine required - smaller application footprint
  • AOT Compatible: Compatible with Ahead-of-Time compilation and trimming
  • Platform Configuration: Supports WebView2 profiles, persistent storage paths, and many other platform-specific options
  • Web APIs: JavaScript execution, bidirectional messaging, cookie management, HTTP header interception
  • Authentication: Web authentication broker for OAuth and web-based authentication
  • Printing: Print web content directly from the WebView

Quick Start

Get started quickly with the WebView component: https://docs.avaloniaui.net/accelerate/components/webview/quickstart

Components

NativeWebView Control

The main control for embedding web content in your app.

<NativeWebView x:Name="WebView" 
               Source="https://avaloniaui.net" />

Documentation: https://docs.avaloniaui.net/accelerate/components/webview/nativewebview

NativeWebDialog

Native web dialog that provides a way to display web content in a separate window, particularly useful for platforms like Linux where embedded WebView controls might not be available

Documentation: https://docs.avaloniaui.net/accelerate/components/webview/nativewebdialog

WebAuthenticationBroker

WebAuthenticationBroker is a utility class that facilitates OAuth and other web-based authentication flows by providing a secure way to handle web authentication in desktop applications.

Documentation: https://docs.avaloniaui.net/accelerate/components/webview/webauthenticationbroker

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-android36.0 is compatible.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
12.0.0-preview1 112 2/19/2026
11.3.16 4,945 1/30/2026
11.3.15 7,209 11/7/2025
11.3.14 378 11/3/2025
11.3.13 758 10/28/2025
11.3.12 815 10/13/2025
11.3.11 796 10/13/2025

# 12.0.0-preview1

- Compatibility with Avalonia 12.0, while keeping 11.1 support
- Dropped .NET Standard and .NET Framework support

# 11.3.16

- New WebViewAdapterInfo API to retrieve WebView engine and availability information
- Implemented Android printing functions
- Implemented `PrintToPdfStreamAsync(WebViewPrintSettings)` overload
- Fixed Windows 7 support for WebView2
- Experimental WebView2 offscreen rendering, can be enabled via WindowsWebView2EnvironmentRequestedEventArgs

# 11.3.15

- Fixed threading issue on XPF

# 11.3.14

- Fixed crash when using `NativeWebView.Background` on iOS

# 11.3.13

- Improves Mono AOT compatibility, removing warnings
- Fixes GTK NativeWebDialog.Canceling event not being raised

# 11.3.11

- First public NuGet release!
- Adds `NativeWebView.ShowPrintUI` and `NativeWebView.PrintToPdfStreamAsync` methods for printing web content, supported on Windows, macOS and Linux GTK (with NativeWebDialog)

# 11.3.10

- Fixes Android WebAuthenticationBroker not working with major OAuth providers
- Adds `WindowsWebView2EnvironmentRequestedEventArgs.AllowSingleSignOnUsingOSPrimaryAccount` parameter
- Adds `EnvironmentRequestedEventArgs.GetDeferrer()` for async initialization of the webview environment, if necessary

# 11.3.9

- Implements Android `WebResourceRequested` header interception
- Fixes Android `WebResourceRequested` not being executed on the UI thread

# 11.3.8

- Fixes Gtk `NativeWebDialog` depending on the libsoap3.0, even if it's not installed
- Fixes Gtk `NativeWebDialog` relying on `g_timeout_add_once` on older platforms

# 11.3.7

- Implements Android `NativeWebDialog`
- Implements Android `AndroidWebViewEnvironmentRequestedEventArgs`
- Fixes Gtk `NativeWebDialog` crashing on some .NET runtime versions
- Fixes Gtk AOT compilation

# 11.3.6

- Fixes GTK `NativeWebDialog` on XPF
- Adds WebView2 STA thread check

# 11.3.5

- Fixes WebView2 on ARM64 processors

# 11.3.4

- Imroves automatic sizing of `NativeWebView`
- Imrpoves NuGet packaging, readme, description

# 11.3.3

- Makes `NativeWebView` compatible with XPF

# 11.3.2

- Extended focus handling support for WebView2
- Adds strong naming to the assembly
- Implements `NativeWebView.Background`, with support for transparent background on some backends

# 11.3.1

- Implements `NativeWebView.EnvironmentRequested` and `NativeWebDialog.EnvironmentRequested`
- Enhanced platform interop with typed `NativeWebView.TryGetPlatformHandle`
- Added `AdapterInitialized` and `AdapterDestroyed`
- Added `WebResourceRequested`
- Added `WebAuthenticationBroker` options for `NonPersistent` and `NativeWebDialogFactory`

# 11.3.0

- Initial release