---
title: "MAUI"
description: "Learn about Sentry's .NET integration with .NET Multi-platform App UI (MAUI)."
url: https://docs.sentry.io/platforms/dotnet/guides/maui/
---

# MAUI | Sentry for MAUI

Sentry has an integration for the [.NET Multi-platform App UI (MAUI)](https://dotnet.microsoft.com/apps/maui) through the [Sentry.Maui NuGet package](https://www.nuget.org/packages/Sentry.Maui).

## [Overview of the features](https://docs.sentry.io/platforms/dotnet/guides/maui.md#overview-of-the-features)

* Easy MAUI integration by calling `UseSentry` on your `MauiAppBuilder`
* All the features of our main [.NET SDK](https://docs.sentry.io/platforms/dotnet.md), for your managed code
* Native crash reporting for Android, leveraging our [Android SDK](https://docs.sentry.io/platforms/android.md)
* Native crash reporting for iOS and Mac Catalyst, leveraging our [Cocoa SDK for iOS](https://docs.sentry.io/platforms/apple/guides/ios.md)
* Managed crash reporting (unhandled exceptions), on all MAUI platforms (iOS, Android, Windows, Mac Catalyst, and Tizen)
* Line numbers for your .NET stack traces when PDBs are uploaded to Sentry
* Automatic breadcrumbs for MAUI app lifecycle and UI events
* Detailed device and runtime information passed on every event
* Automatic session tracking enabled, to support [release health](https://docs.sentry.io/product/releases.md)

## [Features](https://docs.sentry.io/platforms/dotnet/guides/maui.md#features)

In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](https://docs.sentry.io/concepts/key-terms/tracing.md).

Select which Sentry features you'd like to install in addition to Error Monitoring to get the corresponding installation and configuration instructions below.

## [Install](https://docs.sentry.io/platforms/dotnet/guides/maui.md#install)

Error Monitoring\[ ]Tracing

Add the Sentry dependency to your .NET MAUI application:

```shell
dotnet add package Sentry.Maui -v 6.3.0
```

This package extends [Sentry.Extensions.Logging](https://docs.sentry.io/platforms/dotnet/guides/extensions-logging.md). This means that besides the MAUI related features, through this package you'll also get access to all the framework's logging integration and also the features available in the main [Sentry](https://docs.sentry.io/platforms/dotnet.md) SDK.

## [Configure](https://docs.sentry.io/platforms/dotnet/guides/maui.md#configure)

In your `MauiProgram.cs` file, call `UseSentry` on your `MauiAppBuilder`, and include any options you would like to set. The `Dsn` is the only required parameter.

```csharp
public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()

        // Add this section anywhere on the builder:
        .UseSentry(options =>
        {
            // The DSN is the only required setting.
            options.Dsn = "___PUBLIC_DSN___";

            // Use debug mode if you want to see what the SDK is doing.
            // Debug messages are written to stdout with Console.Writeline,
            // and are viewable in your IDE's debug console or with 'adb logcat', etc.
            // This option is not recommended when deploying your application.
            options.Debug = true;

            // Adds request URL and headers, IP and name for users, etc.
            options.SendDefaultPii = true;

            // ___PRODUCT_OPTION_START___ performance
            // Set TracesSampleRate to 1.0 to capture 100% of transactions for tracing.
            // We recommend adjusting this value in production.
            options.TracesSampleRate = 1.0;
            // ___PRODUCT_OPTION_END___ performance

            // Other Sentry options can be set here.
        })

        // ... the remainder of your MAUI app setup

    return builder.Build();
}
```

### [Options](https://docs.sentry.io/platforms/dotnet/guides/maui.md#options)

As previously mentioned, this package is a wrapper around [Sentry.Extensions.Logging](https://docs.sentry.io/platforms/dotnet/guides/extensions-logging.md) and [Sentry](https://docs.sentry.io/platforms/dotnet.md). Please refer to the documentation of these packages to get the options that are defined at those levels.

Below, the options that are specific to `Sentry.Maui` will be described.

#### [IncludeTextInBreadcrumbs](https://docs.sentry.io/platforms/dotnet/guides/maui.md#includetextinbreadcrumbs)

This option controls whether elements that implement the `IText` interface (such as `Button`, `Label`, `Entry`, and others) will have their text included on breadcrumbs. This option is disabled by default.

Use caution when enabling, as such values may contain personally identifiable information (PII).

#### [IncludeTitleInBreadcrumbs](https://docs.sentry.io/platforms/dotnet/guides/maui.md#includetitleinbreadcrumbs)

This option controls whether elements that implement the `ITitledElement` interface (such as `Window`, `Page`, and others) will have their titles included on breadcrumbs. This option is disabled by default.

Use caution when enabling, as such values may contain personally identifiable information (PII).

#### [IncludeBackgroundingStateInBreadcrumbs](https://docs.sentry.io/platforms/dotnet/guides/maui.md#includebackgroundingstateinbreadcrumbs)

Controls whether the breadcrumb sent for the `Window.Backgrounding` event will include state data from `BackgroundingEventArgs.State`. This option is disabled by default.

Use caution when enabling, as such values may contain personally identifiable information (PII).

## [Verify](https://docs.sentry.io/platforms/dotnet/guides/maui.md#verify)

This snippet includes an intentional error, so you can test that everything is working as soon as you set it up.

```csharp
try
{
    throw null;
}
catch (Exception ex)
{
    SentrySdk.CaptureException(ex);
}
```

## [Next Steps](https://docs.sentry.io/platforms/dotnet/guides/maui.md#next-steps)

* Explore [practical guides](https://docs.sentry.io/guides.md) on what to monitor, log, track, and investigate after setup

## Other .NET Frameworks

- [.NET for Android](https://docs.sentry.io/platforms/dotnet/guides/android.md)
- [.NET for iOS, macOS, and Mac Catalyst](https://docs.sentry.io/platforms/dotnet/guides/apple.md)
- [ASP.NET](https://docs.sentry.io/platforms/dotnet/guides/aspnet.md)
- [ASP.NET Core](https://docs.sentry.io/platforms/dotnet/guides/aspnetcore.md)
- [AWS Lambda](https://docs.sentry.io/platforms/dotnet/guides/aws-lambda.md)
- [Azure Functions](https://docs.sentry.io/platforms/dotnet/guides/azure-functions-worker.md)
- [Blazor WebAssembly](https://docs.sentry.io/platforms/dotnet/guides/blazor-webassembly.md)
- [Entity Framework](https://docs.sentry.io/platforms/dotnet/guides/entityframework.md)
- [Google Cloud Functions](https://docs.sentry.io/platforms/dotnet/guides/google-cloud-functions.md)
- [log4net](https://docs.sentry.io/platforms/dotnet/guides/log4net.md)
- [Microsoft.Extensions.Logging](https://docs.sentry.io/platforms/dotnet/guides/extensions-logging.md)
- [NLog](https://docs.sentry.io/platforms/dotnet/guides/nlog.md)
- [Serilog](https://docs.sentry.io/platforms/dotnet/guides/serilog.md)
- [Windows Forms](https://docs.sentry.io/platforms/dotnet/guides/winforms.md)
- [WinUI](https://docs.sentry.io/platforms/dotnet/guides/winui.md)
- [WPF](https://docs.sentry.io/platforms/dotnet/guides/wpf.md)
- [Xamarin](https://docs.sentry.io/platforms/dotnet/guides/xamarin.md)

## Topics

- [Capturing Errors](https://docs.sentry.io/platforms/dotnet/guides/maui/usage.md)
- [Enriching Events](https://docs.sentry.io/platforms/dotnet/guides/maui/enriching-events.md)
- [Extended Configuration](https://docs.sentry.io/platforms/dotnet/guides/maui/configuration.md)
- [Logs](https://docs.sentry.io/platforms/dotnet/guides/maui/logs.md)
- [Data Management](https://docs.sentry.io/platforms/dotnet/guides/maui/data-management.md)
- [Tracing](https://docs.sentry.io/platforms/dotnet/guides/maui/tracing.md)
- [Profiling](https://docs.sentry.io/platforms/dotnet/guides/maui/profiling.md)
- [Security Policy Reporting](https://docs.sentry.io/platforms/dotnet/guides/maui/security-policy-reporting.md)
- [Crons](https://docs.sentry.io/platforms/dotnet/guides/maui/crons.md)
- [Migration Guide](https://docs.sentry.io/platforms/dotnet/guides/maui/migration.md)
- [Troubleshooting](https://docs.sentry.io/platforms/dotnet/guides/maui/troubleshooting.md)
- [User Feedback](https://docs.sentry.io/platforms/dotnet/guides/maui/user-feedback.md)
- [Metrics](https://docs.sentry.io/platforms/dotnet/guides/maui/metrics.md)
- [Unit Testing](https://docs.sentry.io/platforms/dotnet/guides/maui/unit-testing.md)
- [Legacy SDK](https://docs.sentry.io/platforms/dotnet/guides/maui/legacy-sdk.md)