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
MediatR.Extensions.Microsoft.DependencyInjection
MediatR extensions for ASP.NET Core

Version Last updated
13.0.0 07/03/2025
12.5.0 04/02/2025
12.4.1 03/12/2025
12.4.0 04/21/2025
12.3.0 06/15/2025
12.2.0 04/17/2025
12.1.1 04/21/2025
12.0.1 04/21/2025
11.1.0 04/21/2025
11.0.0 06/05/2025
10.0.1 04/16/2025
10.0.0 06/15/2025
9.0.0 03/14/2025
8.1.0 04/21/2025
8.0.2 04/21/2025
8.0.1 04/18/2025
8.0.0 04/21/2025
7.0.0 04/21/2025
6.0.0 04/21/2025
5.1.0 04/21/2025
5.0.1 04/16/2025
5.0.1-alpha-0002 04/21/2025
5.0.1-alpha-0001 04/21/2025
4.1.0 04/13/2025
4.0.1 04/17/2025
4.0.0 04/08/2025
4.0.0-alpha-0002 04/21/2025
4.0.0-alpha 04/03/2025
3.0.1 03/30/2025
3.0.0 04/21/2025
2.1.0 04/20/2025
2.1.0-beta-19 03/29/2025
2.0.2 04/21/2025
2.0.1 04/24/2025
2.0.0 04/12/2025
2.0.0-beta-005 04/24/2025
2.0.0-beta-004 04/21/2025
2.0.0-beta-003 04/08/2025
2.0.0-beta-002 04/21/2025
2.0.0-beta-001 04/21/2025
1.0.0 03/12/2025
0.5.0 04/21/2025
0.4.0 04/08/2025
0.3.0 04/18/2025
0.2.0 04/11/2025
0.1.0 04/13/2025