Compatibility
This version of the documentation is archived and no longer supported. View the current documentation to learn how to upgrade your version of the Node.js driver.
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 8.0 | 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.9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ [2] | ||||
6.0 to 6.8 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.7 to 5.9 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
5.0 to 5.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
4.8 to 4.17 | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
4.2 to 4.7 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
4.0 to 4.1 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
3.7 [1] | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.6 | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.3 to 3.5 | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
3.1 to 3.2 | ⊛ | ⊛ | ⊛ | ⊛ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
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. |
| [2] | Support for MongoDB 3.6 is deprecated in Node.js driver v6.9. |
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 [3] | ✓ | ✓ | ✓ | |||||||||
5.6.X to 5.9.X | ✓ | ✓ | ✓ | ✓ | ||||||||
5.0.0 to 5.5.X | ✓ | ✓ | ✓ | |||||||||
4.X | ✓ | ✓ | ✓ | ✓ | ||||||||
3.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
2.X | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
>= 1.4.18 | ✓ | ✓ | ✓ | |||||||||
1.4.X | ✓ | ✓ |
| [3] | Versions 6.0 and later of the Node.js driver require Node.js v16.20.1 or later. |
For more information on how to read the compatibility tables, see our guide on MongoDB Compatibility Tables.