Compatibility
On this page
MongoDB Compatibility
The following compatibility table specifies the recommended versions of the MongoDB Node.js driver for use with MongoDB.
The first column lists the driver version.
Important
MongoDB ensures compatibility between the MongoDB Server and the drivers for three years after the server version's end of life (EOL) date. To learn more about the MongoDB release and EOL dates, see MongoDB Software Lifecycle Schedules.
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. |
Node.js Driver Version | MongoDB 7.0 | 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|
6.1 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
6.0 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.8 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.6 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.5 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.4 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.3 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.2 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.1 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.0 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.17 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.16 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.15 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.14 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.13 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.12 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.11 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.10 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.9 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.8 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.7 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.5 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.4 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.3 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.2 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.1 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
4.0 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
3.7 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.5 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.4 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.3 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.2.1 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.1 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.0 | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.2.12 | ✓ | ✓ | ✓ | ✓ | |||||||
2.0.14 | ✓ | ✓ | |||||||||
1.4.29 | ✓ | ✓ |
| [1] | When using Node.js Driver version 3.7, you must set the useUnifiedTopology flag to true for certain features. |
Language Compatibility
The following compatibility table specifies the recommended versions of the MongoDB Node.js driver for use with a specific version of Node.js.
The first column lists the driver version.
Node.js Driver Version | Node.js v20.x.x | Node.js v18.x.x | Node.js v16.x.x | Node.js v14.x.x | Node.js v12.x.x | Node.js v10.x.x | Node.js v8.X.X | Node.js v6.X.X | Node.js v4.X.X | Node.js v0.12.X | Node.js v0.10.X | Node.js v0.8.X |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
6.X [2] | ✓ | ✓ | ✓ | |||||||||
5.6.X to 5.8.X | ✓ | ✓ | ✓ | ✓ | ||||||||
5.0.0 to 5.5.X | ✓ | ✓ | ✓ | |||||||||
4.X | ✓ | ✓ | ✓ | ✓ | ||||||||
3.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
>= 1.4.18 | ✓ | ✓ | ✓ | |||||||||
1.4.X | ✓ | ✓ |
| [2] | Versions 6.0 and later of the Node.js driver require Node.js v16.20.1 or later. |
Component Compatibility
The following table describes add-on component version compatibility for versions of the MongoDB Node.js driver. Any other combination of packages might be unstable.
Component | Node.js Driver v6.x | Node.js Driver v5.x | Node.js Driver v4.x | Node.js Driver v3.x |
|---|---|---|---|---|
bson | ^6.0.0 | ^5.0.0 | ^4.0.0 | ^1.0.0 |
bson-ext | ^4.0.0 | ^1.0.0 or ^2.0.0 | ||
kerberos | ^2.0.1 | ^1.0.0 or ^2.0.0 | ^1.0.0 or ^2.0.0 | ^1.0.0 |
mongodb-client-encryption | ^6.0.0 | ^2.3.0 | ^1.0.0 or ^2.0.0 | ^1.0.0 |
mongodb-legacy | ^6.0.0 | ^5.0.0 | ^4.0.0 | |
@mongodb-js/zstd | ^1.1.0 | ^1.0.0 | ^1.0.0 |
For more information on how to read the compatibility tables, see our guide about MongoDB Compatibility Tables.