MediatR 13.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>";
})

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
 42
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 44
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 45
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 46
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 47
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 48
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 49
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 50
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 54
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 55
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 59
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 179
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core
 289

.NET 8.0

.NET Standard 2.0

.NET 9.0

Version Downloads Last updated
13.0.0 2 07/04/2025
12.5.0 26 04/05/2025
12.4.1 263 09/13/2024
12.4.0 221 08/03/2024
12.3.0 73 06/27/2024
12.2.0 180 02/04/2024
12.1.1 49 02/09/2024
12.0.1 42 07/21/2024
11.1.0 70 02/04/2024
11.0.0 134 02/04/2024
10.0.1 122 02/04/2024
10.0.0 53 07/21/2024
9.0.0 57 02/05/2024
8.1.0 48 07/21/2024
8.0.2 55 07/21/2024
8.0.1 56 07/21/2024
8.0.0 54 07/21/2024
7.0.0 50 07/21/2024
6.0.0 52 07/21/2024
5.1.0 45 07/21/2024
5.0.1 43 07/21/2024
5.0.1-alpha-0002 58 07/21/2024
5.0.1-alpha-0001 49 07/21/2024
4.1.0 46 07/21/2024
4.0.1 45 07/21/2024
4.0.0 50 07/21/2024
4.0.0-alpha-0002 46 07/21/2024
4.0.0-alpha 53 07/21/2024
3.0.1 45 07/21/2024
3.0.0 46 07/21/2024
2.1.0 54 07/21/2024
2.1.0-beta-19 47 07/21/2024
2.0.2 42 07/21/2024
2.0.1 50 07/21/2024
2.0.0 47 07/21/2024
2.0.0-beta-005 53 07/21/2024
2.0.0-beta-004 52 07/21/2024
2.0.0-beta-003 51 07/21/2024
2.0.0-beta-002 46 07/21/2024
2.0.0-beta-001 51 07/21/2024
1.0.0 51 07/21/2024
0.5.0 46 07/21/2024
0.4.0 47 07/21/2024
0.3.0 40 07/21/2024
0.2.0 44 07/21/2024
0.1.0 52 07/21/2024