MediatR 14.0.0

MediatR

CI NuGet NuGet MyGet (dev)

Simple mediator implementation in .NET

In-process messaging with no dependencies.

Supports request/response, commands, queries, notifications and events, synchronous and async with intelligent dispatching via C# generic variance.

Examples in the wiki.

Installing MediatR

You should install MediatR with NuGet:

Install-Package MediatR

Or via the .NET Core command line interface:

dotnet add package MediatR

Either commands, from Package Manager Console or .NET Core CLI, will download and install MediatR and all required dependencies.

Using Contracts-Only Package

To reference only the contracts for MediatR, which includes:

  • IRequest (including generic variants)
  • INotification
  • IStreamRequest

Add a package reference to MediatR.Contracts

This package is useful in scenarios where your MediatR contracts are in a separate assembly/project from handlers. Example scenarios include:

  • API contracts
  • GRPC contracts
  • Blazor

Registering with IServiceCollection

MediatR supports Microsoft.Extensions.DependencyInjection.Abstractions directly. To register various MediatR services and handlers:

services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblyContaining<Startup>());

or with an assembly:

services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly));

This registers:

  • IMediator as transient
  • ISender as transient
  • IPublisher as transient
  • IRequestHandler<,> concrete implementations as transient
  • IRequestHandler<> concrete implementations as transient
  • INotificationHandler<> concrete implementations as transient
  • IStreamRequestHandler<> concrete implementations as transient
  • IRequestExceptionHandler<,,> concrete implementations as transient
  • IRequestExceptionAction<,>) concrete implementations as transient

This also registers open generic implementations for:

  • INotificationHandler<>
  • IRequestExceptionHandler<,,>
  • IRequestExceptionAction<,>

To register behaviors, stream behaviors, pre/post processors:

services.AddMediatR(cfg => {
    cfg.RegisterServicesFromAssembly(typeof(Startup).Assembly);
    cfg.AddBehavior<PingPongBehavior>();
    cfg.AddStreamBehavior<PingPongStreamBehavior>();
    cfg.AddRequestPreProcessor<PingPreProcessor>();
    cfg.AddRequestPostProcessor<PingPongPostProcessor>();
    cfg.AddOpenBehavior(typeof(GenericBehavior<,>));
    });

With additional methods for open generics and overloads for explicit service types.

Setting the license key

You can set the license key when registering MediatR:

services.AddMediatR(cfg => 
{
    cfg.LicenseKey = "<license key here>";
})

Or if not using Microsoft.Extensions.DependencyInjection:

Mediator.LicenseKey = "<license key here>";

[!TIP] The license key does not need to be set on client applications (such as Blazor WASM). Turn off the license warning by configuring logging in your logging start configuration: builder.Logging.AddFilter("LuckyPennySoftware.MediatR.License", LogLevel.None);

You can register for your license key at MediatR.io

Showing the top 20 packages that depend on MediatR.

Packages Downloads
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 97
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 99
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 100
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 101
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 102
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 103
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 105
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 106
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 107
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 109
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 110
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 114
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 115
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 116
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 276
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 547

.NET Framework 4.6.2

.NET Standard 2.0

.NET 10.0

.NET 9.0

.NET 8.0

Version Downloads Last updated
14.0.0 20 12/04/2025
14.0.0-beta-1 24 11/21/2025
13.1.0 45 10/25/2025
13.0.0 352 07/04/2025
12.5.0 92 04/05/2025
12.4.1 494 09/13/2024
12.4.0 291 08/03/2024
12.3.0 127 06/27/2024
12.2.0 242 02/04/2024
12.1.1 110 02/09/2024
12.0.1 108 07/21/2024
11.1.0 125 02/04/2024
11.0.0 227 02/04/2024
10.0.1 180 02/04/2024
10.0.0 111 07/21/2024
9.0.0 118 02/05/2024
8.1.0 112 07/21/2024
8.0.2 117 07/21/2024
8.0.1 111 07/21/2024
8.0.0 111 07/21/2024
7.0.0 113 07/21/2024
6.0.0 114 07/21/2024
5.1.0 105 07/21/2024
5.0.1 109 07/21/2024
5.0.1-alpha-0002 113 07/21/2024
5.0.1-alpha-0001 101 07/21/2024
4.1.0 109 07/21/2024
4.0.1 106 07/21/2024
4.0.0 111 07/21/2024
4.0.0-alpha-0002 108 07/21/2024
4.0.0-alpha 117 07/21/2024
3.0.1 113 07/21/2024
3.0.0 103 07/21/2024
2.1.0 116 07/21/2024
2.1.0-beta-19 116 07/21/2024
2.0.2 98 07/21/2024
2.0.1 113 07/21/2024
2.0.0 104 07/21/2024
2.0.0-beta-005 103 07/21/2024
2.0.0-beta-004 112 07/21/2024
2.0.0-beta-003 102 07/21/2024
2.0.0-beta-002 108 07/21/2024
2.0.0-beta-001 117 07/21/2024
1.0.0 108 07/21/2024
0.5.0 104 07/21/2024
0.4.0 99 07/21/2024
0.3.0 96 07/21/2024
0.2.0 101 07/21/2024
0.1.0 105 07/21/2024