GlobalExceptionHandler 1.0.3

There is a newer version of this package available.
See the version list below for details.
dotnet add package GlobalExceptionHandler --version 1.0.3
NuGet\Install-Package GlobalExceptionHandler -Version 1.0.3
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="GlobalExceptionHandler" Version="1.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GlobalExceptionHandler --version 1.0.3
#r "nuget: GlobalExceptionHandler, 1.0.3"
#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.
// Install GlobalExceptionHandler as a Cake Addin
#addin nuget:?package=GlobalExceptionHandler&version=1.0.3

// Install GlobalExceptionHandler as a Cake Tool
#tool nuget:?package=GlobalExceptionHandler&version=1.0.3

Global Exception Handling for ASP.NET Core

Build status

GlobalExceptionHandlerDotNet allows you to configure exceptions handling as a convention as opposed to explicitly within each controller action. This could be particularly helpful in the following circumstances:

  • Reduce boiler plate try-catch logic in your controllers
  • Catch and appropriately handle exceptions outside of the MVC/WebAPI framework
  • You don't want error codes being visible by consuming APIs (return 500 for every exception)

This middleware currently supports WebAPI with MVC support in the works.


GlobalExceptionHandler is available on NuGet and can be installed via the below commands depending on your platform:

$ Install-Package GlobalExceptionHandler

or via the .NET Core CLI:

$ dotnet add package GlobalExceptionHandler

Web API Setup

Within your Startup.cs file's Configure method (be sure to call before UseMvc()):

public class Startup
    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        app.UseWebApiGlobalExceptionHandler(x =>


Returns the following default exception message:

    "error": {
        "exception": "PageNotFoundException",
        "message": "Page could not be found"

This exception message can be overridden via the ExceptionFormatter method like so:

app.UseWebApiGlobalExceptionHandler(x =>
    x.MessageFormatter(exception => JsonConvert.SerializeObject(new
        error = new
            exception = exception.GetType().Name,
            message = exception.Message

Alternatively you can set the formatter to be unique per exception registered. This will override the root x.MessageFormatter referenced above.

app.UseWebApiGlobalExceptionHandler(x =>
        exception => JsonConvert.SerializeObject(new
            error = new
                message = "Oops, something went wrong"
    x.MessageFormatter(exception => "This formatter will be overridden when an ArgumentException is thrown");

Configuration Options:

  • ContentType - Specify the returned content type (default is application/json).

  • MessageFormatter(Func<Exception, string>) - Overrides default JSON message formatter; this is useful if you want to change the error response format or type (XML for instance).

x.MessageFormatter((exception) => {
    return "Oops, something went wrong! Check the logs for more information.";

MVC Setup

Work in progress.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (7)

Showing the top 5 NuGet packages that depend on GlobalExceptionHandler:

Package Downloads

Enable content negotiation for GlobalExceptionHandlerDotNet when using ASP.NET Core MVC


A common library for implementing CQRS based Api layer.


ASP.NET Core MVC core components extensions.


Basis for the presentation layer of the Harpy Framework


Basis for any Packs API

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.0.2 1,656,198 3/15/2019
4.0.1 3,870 2/26/2019
4.0.0 239,501 10/27/2018
4.0.0-beta2 9,211 9/20/2018
4.0.0-beta1 1,785 9/18/2018
3.0.0 66,377 12/20/2017
2.0.0 8,789 11/27/2017
1.0.3 4,912 10/9/2017
1.0.2 1,778 9/14/2017
1.0.1 1,604 9/14/2017
1.0.0 1,748 9/14/2017
1.0.0-beta 1,436 9/13/2017

Bug fixes, add logging endpoint