What's New

What's New in 5.11.1

To learn more about this release, see the v5.11.1 Release Notes on GitHub.

What's New in 5.11

The 5.11 driver release does not include any changes, fixes, or features that apply to the Scala driver.

To learn more about this release, see the v5.11 Release Notes on GitHub.

What's New in 5.10

The 5.10 driver release includes the following changes, fixes, and features:

• Removes the stale @Beta annotation from the SearchOptions and VectorSearchOptions classes.

• Adds the $scoreFusion aggregation stage, which combines and normalizes the scores of multiple search pipelines. This stage requires MongoDB 8.2 or later.

• Adds a fluent builder API for the $score aggregation stage. Use this API to configure score normalization, weighting, and score details. This feature requires MongoDB 8.2 or later.

• Adds the parentFilter and nestedOptions options, which allow nested embeddings and arrays of embeddings in $vectorSearch queries.

To learn more about this release, see the v5.10 Release Notes on GitHub.

What's New in 5.9.2

The 5.9.2 driver patch release includes the following changes:

• Fixes an issue where ProxySettings.toString() included the SOCKS5 proxy username and password, which caused these credentials to appear in application logs. This issue affects driver versions 4.11.0 through 5.9.1. To learn more, see JAVA-6266 and CVE-2026-18710.

To learn more about this release, see the v5.9.2 Release Notes on GitHub.

What's New in 5.9

The 5.9 driver release includes the following changes, fixes, and features:

• Promotes Queryable Encryption (QE) prefix, suffix, and substring queries to general availability (GA). These query types are supported on MongoDB 9.0 and later. To learn more about QE, see In-Use Encryption.

• Renames the explicit encryption API for QE string queries from Text to String. To perform a QE string query, make the following changes:

  • Use the StringOptions class instead of TextOptions.

  • Use the EncryptOptions.stringOptions() method instead of textOptions().

  • Use the EncryptOptions.getStringOptions() method instead of getTextOptions().

  • Set the encryption algorithm to "String".

• Upgrades the libmongocrypt version to 1.20.0.

To learn more about this release, see the v5.9 Release Notes on GitHub.

What's New in 5.8

The 5.8 driver release includes the following changes, fixes, and features:

• Adds BinaryVector and VectorSearchQuery overloads to the vectorSearch() method.

• Adds a typed builder API for vector search index definitions.

• Adds support for the $rerank aggregation stage. When connected to an Atlas cluster running MongoDB 8.3 or later, you can use the Aggregates.rerank() builder method to create this stage.

• Adds support for the vectorSearch operator in a $search pipeline stage. You can use the SearchOperator.vectorSearch() builder method to perform approximate nearest neighbor (ANN) vector search, or SearchOperator.vectorSearchExact() for exact nearest neighbor (ENN) search. The returned VectorSearchOperator supports a filter() method to apply lexical prefilters.

• Adds support for configuring stored source on vector search index definitions by using the storedSource() method in the VectorSearchIndexDefinition class.

• Adds support for requesting stored source fields in $vectorSearch results by using the returnStoredSource() method in the VectorSearchOptions class.

• Optimizes RawBsonDocument encode and decode performance by eliminating intermediate allocations.

• Fixes an OSGi bundle resolution failure when Micrometer is not present.

• Adds Javadoc documentation to the MongodbObservation and MongodbObservationContext classes.

• Upgrades the libmongocrypt version to 1.18.1.

To learn more about this release, see the v5.8 Release Notes on GitHub.

What's New in 5.7.1

The 5.7.1 driver patch release includes the following changes:

• Fixes an issue where the Scala 3 artifact was not published in version 5.7.0.

• Fixes Javadoc warnings in the Micrometer integration.

• Marks Micrometer OSGi imports as optional to resolve bundle resolution issues in OSGi runtime environments.

To learn more about this release, see the v5.7.1 Release Notes on GitHub.

What's New in 5.7

The 5.7 driver release includes the following changes, fixes, and features:

• Adds support for Scala 3. The driver now publishes artifacts for Scala 3 in addition to existing Scala 2.11, 2.12, and 2.13 artifacts. You can use the driver with any supported Scala version by using the %% operator in your build.sbt file, which automatically selects the correct artifact for your Scala version.

• Important: An upcoming minor release will drop support for MongoDB Server version 4.2 and raise the minimum supported version to 4.4. This change aligns with the MongoDB Software Lifecycle Schedules.

  We recommend making changes to your application to accommodate breaking changes. To learn more about upgrading your server version, see the Release Notes section in the MongoDB Server manual.

• Adds Scala 3 support.

• Adds auto-embedding support as part of vector search APIs.

• Adds Micrometer/OpenTelemetry tracing support to the reactive-streams driver, and includes general Micrometer support improvements.

• Adds stack-safe async loop support with trampoline pattern to prevent stack overflow errors.

• Improves client-side timeout handling to better account for round-trip time (RTT) variations, along with various small timeout-related improvements.

• Reuses ConnectionSource to avoid extra server selection.

• Restores the optimized codec path for RawBsonDocument encoding, fixing a performance regression.

• Releases the connection between empty getMore responses in AsyncCommandCursor, preventing connection pool exhaustion when idle change streams reach maxPoolSize.

• The encryption client now uses writeConcern majority.

• Handles unexpected end-of-stream errors from KMS.

• Fixes JsonBsonEncoder parsing of JsonPrimitive numbers, where scientifically formatted numbers were parsed as plain Ints or Longs.

• Simplifies ServerMonitor thread names and removes the = character, which some monitoring systems cannot process.

• Fixes Kotlin BSON decoding of optionals.

• Upgrades libmongocrypt to 1.17.3.

• Uses ZstdInputStreamNoFinalizer for Zstandard decompression.

• Updates Netty to the latest version.

• Updates Snappy for the latest security fixes.

• Updates JUnit 5 to the latest version.

• Aligns the log level to warning when removing a server from the cluster.

What's New in 5.6

The 5.6 driver release includes the following changes, fixes, and features:

What's New in 5.5.1

The 5.5.1 driver patch release includes the following changes:

• Fixes an issue where OIDC reauthentication failed when triggered by an operation run in a session, including operations run in a transaction.

What's New in 5.5

The 5.5 driver release includes the following changes, fixes, and features:

• Adds support for the connectTimeoutMS option when using the default TLS transport layer.

• Introduces performance improvements that are reflected in the driver performance benchmarks. To view the results of the performance benchmark tests, see the following Performance Improvements section.

What's New in 5.4

The 5.4 driver release includes the following changes, fixes, and features:

• Implements a client bulk write API that allows you to perform write operations on multiple databases and collections in the same call. To learn more about this feature, see the Client Bulk Write section of the Bulk Write Operations guide.

• Supports $lookup operations for CSFLE and QE. To learn more, see the following references in the Server manual:

  • $lookup and $graphLookup Behavior for CSFLE

  • $lookup and $graphLookup Behavior for QE

• Introduces a Bill of Materials (BOM) to manage versions of MongoDB JVM artifacts that you might use in your application. To view instructions on adding the BOM to your application, see the mongodb-driver-bom dependency listing on the Maven Repository website. You can use the BOM only if you are using Maven as your dependency manager, as sbt does not support BOMs.

• Updates AWS SDK dependencies to 2.30.31 and 1.12.782 for testing the MONGODB-AWS authentication mechanism.

• Adds a sort option to the ClientUpdateOneOptions and ClientReplaceOneOptions classes. This change allows you to set a sort order for update and replace operations in client bulk writes. To learn more, see the Update Operations and Replace Operations sections of the Bulk Write Operations guide.

• Adds Kubernetes support for OIDC authentication. To learn more, see the MongoCredential API documentation.

• Adds first class support for the following MongoDB Search query operators:

  • phrase

  • regex

  • queryString

  • equals

  • moreLikeThis

  • in

  • wildcard

  To learn more, see the Search Operator Helper Methods section of the Aggregation guide.

• Updates cursors to refresh the timeoutMS setting when you call close() without affecting the operation timeout.

• Enables you to use an index when calling the distinct() method by specifying a hint option.

To view a full list of changes in this release, see the v5.4 release notes on GitHub.

What's New in 5.3

The 5.3 driver release includes the following changes, fixes, and features:

• Important: The next minor release will drop support for MongoDB Server version 4.0 and raise the minimum supported version to 4.2. We recommend making changes to your application to accommodate breaking changes. See the Release Notes section in the Server manual to learn more about upgrading.

• Adds the BinaryVector class to implement BSON Binary Subtype 9 for vector storage and retrieval. This class provides more effective storage of values compared a list of Double instances. You can create the following vector types based on the type of elements your vector contains:

  • Int8BinaryVector: Vector of 8-bit signed integers

  • Float32BinaryVector: Vector of floating-point numbers

  • PackedBitBinaryVector: Binary quantized vector (In beta and subject to change before becoming generally available)

  To learn more about this feature, see Vector Quantization in the Atlas documentation. To learn about this type, see the BinaryVector API documentation.

• Removes explicit fairness from the connection pool implementation. This change might contribute to better throughput when you use a MongoClient instance in many application threads. However, this change might cause increased tail latency.

• Adds a sort option to the updateOne() and replaceOne() methods. This change also allows you to set a sort as an option when creating ReplaceOneModel and UpdateOneModel instances. To learn more, see the Update Documents, Replace Documents, and Bulk Write Operations guides.

What's New in 5.2

The 5.2 driver release includes the following changes, fixes, and features:

What's New in 5.1.3

The 5.1.3 driver patch release includes the following changes:

What's New in 5.1.1

The 5.1.1 driver patch release includes the following changes:

• When using the MONGODB-OIDC authentication mechanism, you must not include comma characters in the authMechanismProperties connection string value.

What's New in 5.1

To learn about other changes introduced in v5.1, see the What's New guide in the Java Sync Driver documentation.