Xamarin.Essentials: Browser

The Browser class enables an application to open a web link in the optimized system preferred browser or the external browser.

Get started

To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Using Browser

Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

The Browser functionality works by calling the OpenAsync method with the Uri and BrowserLaunchMode.

public class BrowserTest
    public async Task OpenBrowser(Uri uri)
        await Browser.OpenAsync(uri, BrowserLaunchMode.SystemPreferred);

This method returns after the browser was launched and not necessarily closed by the user. The bool result indicates whether the launching was successful or not.


When using the system preferred browser there are several customization options available for iOS and Android. This includes a TitleMode (Android only), and preferred color options for the Toolbar (iOS and Android) and Controls (iOS only) that appear.

These options are specified using BrowserLaunchOptions when calling OpenAsync.

await Browser.OpenAsync(uri, new BrowserLaunchOptions
                    LaunchMode = BrowserLaunchMode.SystemPreferred,
                    TitleMode = BrowserTitleMode.Show,
                    PreferredToolbarColor = Color.AliceBlue,
                    PreferredControlColor = Color.Violet

Browser Options

Platform Implementation Specifics

The Launch Mode determines how the browser is launched:

System Preferred

Custom Tabs will attempted to be used to load the Uri and keep navigation awareness.


An Intent will be used to request the Uri be opened through the systems normal browser.


Find more Xamarin videos on Channel 9 and YouTube.