Compatibility
MongoDB Compatibility
The following compatibility table specifies the recommended version(s) of the MongoDB .NET/C# Driver for use with a specific version of MongoDB.
The first column lists the driver version.
Compatibility Table Legend
Icon | Explanation |
|---|---|
✓ | All features are supported. |
⊛ | The Driver version will work with the MongoDB version, but not all
new MongoDB features are supported. |
No mark | The Driver version is not tested with the MongoDB version. |
.NET/C# Driver Version | MongoDB 6.1 | MongoDB 6.0 | MongoDB 5.0 | MongoDB 4.4 | MongoDB 4.2 | MongoDB 4.0 | MongoDB 3.6 | MongoDB 3.4 | MongoDB 3.2 | MongoDB 3.0 | MongoDB 2.6 |
|---|---|---|---|---|---|---|---|---|---|---|---|
2.19 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.18 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.17 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.16 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.15 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.14 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.13 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.12 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.11 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.10 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.9 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.8 | ⊛ | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.7 | ⊛ | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.6 | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.5 | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.4 | ✓ | ✓ | ✓ | ✓ | |||||||
2.3 | ✓ | ✓ | ✓ | ||||||||
2.2 | ✓ | ✓ | ✓ | ||||||||
2.0 | ✓ | ✓ | |||||||||
1.11 | ✓ | ✓ | ✓ | ||||||||
1.10 | ✓ | ✓ |
The driver doesn't support older versions of MongoDB.
Language Compatibility
The following compatibility table specifies the recommended version of the MongoDB .NET/C# Driver for use with a specific version of C#.
The first column lists the driver version.
.NET/C# Driver Version | .NET 5/6 [1] | .NET Core 3.1 | .NET Core 3.0 | .NET Core 2.2 | .NET Core 2.1 | .NET Core 2.0 | .NET Core 1.1 | .NET Core 1.0 | .NET 4.8 | .NET 4.7 [2] | .NET 4.6 | .NET 4.5 [3] |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
2.19 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.18 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.17 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.16 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.15 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.14 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
2.13 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.12 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.11 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.10 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.8 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.6 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.5 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.4 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.3 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.2 | ✓ | ✓ | ✓ | ✓ | ||||||||
2.0 | ✓ | ✓ | ✓ | ✓ |
Versions 1.10 and 1.11 of the driver are compatible with .NET 3.5 through 4.8 only.
| [1] | When using .NET 5/6, you can't connect to Atlas clusters running MongoDB 4.0 due to a certificate issue. This does not impact clusters running MongoDB 4.2+. |
| [2] | .NET/C# Driver versions 2.14 or later requires .NET Framework 4.7.2 or later. |
| [3] | .NET/C# Driver versions 2.8 to 2.13 requires .NET Framework 4.5.2 or later. |
For more information on how to read the compatibility tables, see our guide on MongoDB Compatibility Tables.