NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #3058 most downloaded on crates.io
Internal macros for the mongodb crate
Latest stable
3.10.0
Last release 19 days ago
03 Nov 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 23 of 25 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
26 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
> This is a security patch release for CVE-2026-120673. Upgrading is recommended for all users.
The MongoDB Rust driver team is pleased to announce the v3.10.0 release of the mongodb crate, now available for download from crates.io.
[!IMPORTANT] This is a security patch release for CVE-2026-120673. Upgrading is recommended for all users.
db.query.text attributeThis release fixes a bug that caused query documents to be recorded in Opentelemetry before automatic encryption was applied, potentially exposing the message plaintext.
Previous versions of the driver would allow the character '|' in client metadata; in order to preserve the mapping between versions and names in the final message, this is now not allowed and attempting to set or add metadata containing this character will result in an error.
This version of the driver now requires a minimum Rust compiler version of 1.94.1.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
> This is a security patch release for CVE-2026-88024. Upgrading is recommended for all users.
The MongoDB Rust driver team is pleased to announce the v3.9.1 release of the mongodb crate, now available for download from crates.io.
[!IMPORTANT] This is a security patch release for CVE-2026-88024. Upgrading is recommended for all users.
This release fixes a bug that would allow certain inputs to delete all files in a GridFS bucket.
The MongoDB Rust driver team is pleased to announce the v3.9.0 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.9.0 release of the mongodb crate, now available for download from crates.io.
This release adds support for the new baseBackoffMS server error field. The driver now uses the value for baseBackoffMS reported by the server in its retry backoff calculations. This new feature is part of MongoDB's Intelligent Workload Management (IWM) and is available on MongoDB Atlas server versions 9.0+.
> This is a security patch release for CVE-2026-81526. Upgrading is recommended for all users.
The MongoDB Rust driver team is pleased to announce the v3.8.2 release of the mongodb crate, now available for download from crates.io.
[!IMPORTANT] This is a security patch release for CVE-2026-81526. Upgrading is recommended for all users.
This release fixes a bug that would allow Client::bulk_write to write to a different database than the one specified in a write model's namespace.
The MongoDB Rust driver team is pleased to announce the v3.8.1 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.8.1 release of the mongodb crate, now available for download from crates.io.
This release fixes two bugs: a potential infinite loop in change streams, and the find_one_and_* methods not reporting errors in some circumstances.
Algorithm::TextPreview is deprecated in favor of Algorithm::String.
The MongoDB Rust driver team is pleased to announce the v3.8.0 release of the mongodb crate, now available for download from crates.io.
The string API for in-use encryption (previously named the text API) is now stable and GA! This brings with it the following changes:
text-indexes-unstable feature is no longer required to enable this API. The feature still exists for backwards compatibility but does nothing.TextOptions struct is now StringOptions.Algorithm::TextPreview is deprecated in favor of Algorithm::String."prefixPreview", "suffixPreview", and "substringPreview" are deprecated in favor of "prefix", "suffix", and "substring" respectively.The GA API requires mongodb server version 9.0. The preview API can continue to be used with pre-9.0 server versions.
As of this release, connecting to server version 4.2 is deprecated. Support for 4.2 will be removed in the 3.9.0 release.
MONGODB-AWS explicit authentication property deprecationThe use of explicit username, password, or the "AWS_SESSION_TOKEN" property with the MONGODB-AWS auth mechanism is deprecated, and will emit warnings when debug assertions are enabled. Support for these will be removed in version 4.0 of the driver.
A long-standing bug in the hickory-resolver case when running on Windows caused performance degredation when using a mongodb+srv connection string. Happily, this bug is now fixed, so users who previously used our recommended workaround of a custom DNS configuration on Windows can now remove that workaround.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.7.0 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.7.0 release of the mongodb crate, now available for download from crates.io.
This release updates the minimum supported rust compiler version to 1.88.
Due to a security advisory, the version of hickory used internally has been updated to 0.26. This should have no user-visible behavior impact.
Client::shutdown improvementsThe implementation of shutdown's wait for server resource cleanup and background task termination has been improved to be more consistent and cover more cases.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.6.0 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.6.0 release of the mongodb crate, now available for download from crates.io.
With 3.6.0, the client has a variety of changes to improve behavior when connected to overloaded servers, most notably retrying against a different server (if available). These features will be functional with MongoDB Atlas Server Version 9.0 and above.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.5.2 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.5.2 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.5.1 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.5.1 release of the mongodb crate, now available for download from crates.io.
This release removes a check added in 3.4.0 that would reject metadata containing the | character.
…field of the auth mechanism properties doc is deprecated; using these is almost never the correct setup and can lead to the driver losing connectivity…
The MongoDB Rust driver team is pleased to announce the v3.5.0 release of the mongodb crate, now available for download from crates.io.
3.5.0 includes the optional socks5-proxy feature, which enables connecting to the database via a SOCKS5 proxy. This can be configured either with the proxyHost, proxyPort, proxyUsername, and proxyPassword connection string options or the ClientOptions::socks5_proxy field.
This release adds support for iterating over the raw document batches returned by the server for cursors rather than individual deserialized values. For some applications, this can enable significant performance improvements; see the module documentation for more details.
Specifying AWS authentication properties via the username and password in URI strings and the AWS_SESSION_TOKEN field of the auth mechanism properties doc is deprecated; using these is almost never the correct setup and can lead to the driver losing connectivity. This functionality will be removed in the next major version of the driver.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.4.1 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.4.1 release of the mongodb crate, now available for download from crates.io.
The driver now includes helpers for building Atlas Search aggregation pipelines. See the documentation for more details and examples.
The driver now supports tracing database commands and driver operations for OpenTelemetry.
The driver now supports text indexes for both automatic and explicit encryption. Note that this feature is in preview and should only be used in experimental workloads. The text-indexes-unstable feature flag must be enabled to use text indexes. The GA version of this feature may not be backwards-compatible with the preview version.
Thank you to @tottoto and @FalkWoldmann for their several contributions to update and refine our dependencies!
Impactful changes are listed below; for a complete list of changes, see this GitHub query.
Display and Serialize for ConnectionString (#1494)Error (#1474)[!NOTE] Version 3.4.0 of the driver was skipped due to an issue in the release process.
Nothing published for this version
With the stabilization of async closures, the convenient transaction API (StartTransaction::and_run) has been deprecated in favor of StartTransaction:…
The MongoDB Rust driver team is pleased to announce the v3.3.0 release of the mongodb crate, now available for download from crates.io.
bson 3.0This version of the driver provides the bson-3 feature, which allows opting in to use the 3.0 version of the bson crate where the driver API exposes those types. Any usage without that feature (e.g. all existing projects) will continue to use the 2.x version. See the bson 3.0 migration guide for more information.
With the stabilization of async closures, the convenient transaction API (StartTransaction::and_run) has been deprecated in favor of StartTransaction::and_run2, which provides the same functionality but without needing to box the closure or pass a distinct data argument.
The driver now supports the use of GSSAPI for authentication of driver connections on Linux, MacOS, and Windows.
The minimum server version supported by the driver is now 4.2; support for 4.0 was deprecated in driver version 3.2.0 and has now been removed.
Impactful changes are listed below; for a complete list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.2.5 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.5 release of the mongodb crate, now available for download from crates.io.
This release fixes a bug that caused the driver to allow invalid TLS certificates when the URI option "tlsInsecure=false" was included in the connection string.
The MongoDB Rust driver team is pleased to announce the v3.2.4 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.4 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.3 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.3 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.2 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.2 release of the mongodb crate, now available for download from crates.io.
RUST-2144 Remove use of deprecated openssl_probe method (#1294, #1297)
The MongoDB Rust driver team is pleased to announce the v3.2.1 release of the mongodb crate, now available for download from crates.io.
openssl_probe method (#1294, #1297)The MongoDB Rust driver team is pleased to announce the v3.2.0 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.2.0 release of the mongodb crate, now available for download from crates.io.
The API for in-use encryption is now stable and has the same backwards compatibility guarantees as the rest of the driver. To reflect this, the feature is now named in-use-encryption; in-use-encryption-unstable will continue to be provided as a compatibility alias. Please note that this is a policy change only and that the API itself has not changed from the previous release.
When looking at the rustdoc for methods with chainable setters for options (e.g. Collection::find), those setters are listed directly in the rustdoc for the method rather than only being visible in the rustdoc for the type of the returned future.
In the next minor version release (3.3.0), the Rust driver will be dropping support for connecting to mongodb server version 4.0. As of that release, the minimum supported server version will be 4.2.
Below are a selected list of changes with user impact; for a full list of changes see this GitHub query.
The MongoDB Rust driver team is pleased to announce the v3.1.1 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.1.1 release of the mongodb crate, now available for download from crates.io.
derivative dependency (#1245)hickory dependencies (#1264)The MongoDB Rust driver team is pleased to announce the v3.1.0 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.1.0 release of the mongodb crate, now available for download from crates.io.
This release provides compatibility with MongoDB 8.0, including support for a number of new in-use encryption features.
The MongoDB Rust driver team is pleased to announce the v3.0.1 release of the mongodb crate, now available for download from crates.io.
The MongoDB Rust driver team is pleased to announce the v3.0.1 release of the mongodb crate, now available for download from crates.io.
This release fixes two bugs:
Collection::watch didn't use the Collection's type parameterFor detailed information on breaking changes and examples of migrating from 2.x to 3.0, please see the migration guide.
The MongoDB Rust driver team is pleased to announce the v3.0.0 release of the mongodb crate, now available for download from crates.io.
3.0 introduces a wide variety of improvements that required backwards-incompatible API changes; in most cases these changes should require only minor updates in application code.
Most notably:
EventHandler type, which can be constructed from a callback, async callback, or an async channel sender.tokio; support for async-std has been discontinued.For detailed information on breaking changes and examples of migrating from 2.x to 3.0, please see the migration guide.
The Rust driver now implements the new Bulk Write specification, which supports performing mixed write operations against multiple namespaces in a minimized number of round-trips to the server. This feature is only available for early testing using MongoDB 8.0 release candidate binaries. This feature is not recommended for use in production until the stable release of MongoDB 8.0.
The Rust driver can now authenticate using an OpenID Connect access token, including support for both the machine and human authentication flows, and automatic token acquisition for Azure and GCP.
Below are a selected list of other changes with user impact; for a full list of changes see this GitHub query.
For detailed information on breaking changes and examples of migrating from 2.x to 3.0, please see the migration guide.
The MongoDB Rust driver team is pleased to announce the v3.0.0-beta release of the mongodb crate, now available for download from crates.io.
3.0 introduces a wide variety of improvements that required backwards-incompatible API changes; in most cases these changes should require only minor updates in application code.
Most notably:
EventHandler type, which can be constructed from a callback, async callback, or an async channel sender.tokio; support for async-std has been discontinued.For detailed information on breaking changes and examples of migrating from 2.x to 3.0, please see the migration guide.
The Rust driver now implements the new Bulk Write specification, which supports performing mixed write operations against multiple namespaces in a minimized number of round-trips to the server. This feature is only available for early testing using MongoDB 8.0 release candidate binaries. This feature is not recommended for use in production until the stable release of MongoDB 8.0.
The Rust driver can now authenticate using an OpenID Connect access token, including support for both the machine and human authentication flows, and automatic token acquisition for Azure and GCP.
Below are a selected list of other changes with user impact; for a full list of changes see this GitHub query.
Nothing published for this version
One column per month.