MediatR 12.3.0

dotnet add package MediatR --version 12.3.0
NuGet\Install-Package MediatR -Version 12.3.0
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="MediatR" Version="12.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MediatR --version 12.3.0
#r "nuget: MediatR, 12.3.0"
#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 MediatR as a Cake Addin
#addin nuget:?package=MediatR&version=12.3.0

// Install MediatR as a Cake Tool
#tool nuget:?package=MediatR&version=12.3.0


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 => {

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

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 (1.8K)

Showing the top 5 NuGet packages that depend on MediatR:

Package Downloads

MediatR extensions for ASP.NET Core


An extension for Autofac-IoC to use MediatR and CQRS with ease.


open source custom dotnet extension library


Elsa is a set of workflow libraries and tools that enable lean and mean workflowing capabilities in any .NET Core application. This package provides abstractions and models that are used by Elsa.Core and other related packages. You don't need to reference this package separately if you reference any other Elsa package.


Elsa is a set of workflow libraries and tools that enable lean and mean workflowing capabilities in any .NET Core application. This package contains the core of Elsa. Tip: reference the `Elsa` package instead of this one.

GitHub repositories (160)

Showing the top 5 popular GitHub repositories that depend on MediatR:

Repository Stars
Clean Architecture Solution Template for ASP.NET Core
Clean Architecture Solution Template: A starting point for Clean Architecture with ASP.NET Core
Full Modular Monolith application with Domain-Driven Design approach.
Sample ASP.NET Core 8.0 reference application, powered by Microsoft, demonstrating a layered application architecture with monolithic deployment model. Download the eBook PDF from docs folder.
Distributed Application Framework for .NET
Version Downloads Last updated
12.3.0 218,433 6/6/2024
12.2.0 11,619,888 11/17/2023
12.1.1 11,206,887 7/10/2023
12.0.1 13,429,118 2/23/2023
11.1.0 11,070,051 11/19/2022
11.0.0 13,626,006 9/30/2022
10.0.1 32,136,461 1/10/2022
10.0.0 808,424 1/6/2022
9.0.0 52,614,183 10/8/2020
8.1.0 10,300,400 7/27/2020
8.0.2 2,177,647 6/30/2020
8.0.1 9,760,802 2/27/2020
8.0.0 8,136,669 12/30/2019
7.0.0 11,651,711 4/30/2019
6.0.0 6,159,765 12/10/2018
5.1.0 2,922,596 7/30/2018
5.0.1 895,347 6/1/2018
5.0.1-alpha-0002 41,025 4/5/2018
5.0.1-alpha-0001 3,423 4/5/2018
4.1.0 1,925,934 3/20/2018
4.0.1 1,018,820 12/4/2017
4.0.0 149,696 11/30/2017
4.0.0-alpha-0002 3,450 11/30/2017
4.0.0-alpha 4,790 11/29/2017
3.0.1 1,329,091 3/7/2017
3.0.0 294,621 1/4/2017
2.1.0 723,489 7/1/2016
2.1.0-beta-19 4,115 5/23/2016
2.0.2 345,100 8/5/2015
2.0.1 5,015 8/5/2015
2.0.0 9,266 8/4/2015
2.0.0-beta-005 5,326 7/2/2015
2.0.0-beta-004 17,475 4/20/2015
2.0.0-beta-003 4,455 4/20/2015
2.0.0-beta-002 3,630 4/19/2015
2.0.0-beta-001 5,850 2/16/2015
1.0.0 58,151 12/16/2014
0.5.0 11,457 7/7/2014
0.4.0 3,951 6/16/2014
0.3.0 4,771 3/20/2014
0.2.0 4,830 3/6/2014
0.1.0 100,982 3/4/2014