What's New![](/docs/drivers/go/v1.8/assets/link.svg)
On this page
Tip
Release Notes
To learn more about changes and updates between versions, you can read the release notes published with the driver source code.
Learn what's new in:
What's New in 1.8![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.8 Go driver release include:
Full compatibility with MongoDB 5.1.
Support for KMIP as a KMS provider for CSFLE.
Redesigned driver connection pool for low operation
Context
timeouts and to reduce connection churn. Behavior changes include:New connection creation times out at
connectTimeoutMS
.At most, two new connections can be established at the same time.
Removal of oppressive and unnecessarily gendered language in the Go driver documentation, code, tests, and spec tests.
What's New in 1.7![](/docs/drivers/go/v1.8/assets/link.svg)
Important
Upgrade to Version 1.7.2 or Higher
The 1.7.2 Go driver contains a bug fix for a data race that can occur between
creating and checking out connections when minPoolSize > 0
.
New features of the 1.7 Go driver release include:
Full compatibility with MongoDB 5.0.
Support for the
"snapshot"
read concern outside of multi-document transactions for certain read operations.Improved
WriteException
andBulkWriteException
error messages for schema validation via theWriteError.Details
field.
What's New in 1.6![](/docs/drivers/go/v1.8/assets/link.svg)
Important
Upgrade to Version 1.6.2 or Higher
The 1.6.2 Go driver contains a bug fix for a data race that can occur between
creating and checking out connections when minPoolSize > 0
.
New features of the 1.6 Go driver release include:
Support for the MongoDB Stable API. For more information, see the Stable API Guide.
Support for connections to any MongoDB service that runs behind a load balancer.
Support for creating time series collections. For more information, see the Time Series Collections Guide.
Let
option for aggregate expressions.
What's New in 1.5![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.5 Go driver release include:
Support for Azure and GCP key-management services with Client-side Field Level Encryption.
New errors API to detect duplicate-key errors, timeouts, and network errors.
Server monitoring to monitor changes on a MongoDB deployment.
Errors to prevent unexpected behavior on maps that contain multiple keys being used as a hint option, as a sort option, or for index creation.
What's New in 1.4![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.4 Go driver release include:
Full compatibility with MongoDB 4.4.
Support for stapled and non-stapled OCSP verification.
New
tlsDisableOCSPEndpointCheck=true
URI option to disable sending HTTP requests if the OCSP responder is not reachable from the driver and there is no stapled response.Additional context to errors encountered during BSON unmarshalling.
Proper
Unwrap
functions for various driver error types.
What's New in 1.3![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.3 Go driver release include:
mgocompat
package that exports a BSON registry compatible withglobalsign/mgo/bson
, which can be used via theClientOptions.SetRegistry
method.RegisterTypeEncoder
andRegisterHookEncoder
methods, which replace the deprecatedRegisterEncoder
method. A corresponding change has been made to replaceRegisterDecoder
.
What's New in 1.2![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.2 Go driver release include:
Support for CSFLE.
bson.MarshalValue
function, which marshals Go types to BSON.StringCodec
, which allows non-string fields to be decoded into a String field in a struct.IntCodec
,UIntCodec
,BoolCodec
, andFloatCodec
added tomgocompat
to allow codecs to convert between numbers and booleans.
What's New in 1.1![](/docs/drivers/go/v1.8/assets/link.svg)
New features of the 1.1 Go driver release include:
Full compatibility with MongoDB 4.2.
Redesigned lower-level driver implementation to improve maintainability and performance.
Connection Monitoring and Pooling specifications to monitor various connection and connection pool events with improved utilization.
What's New in 1.0![](/docs/drivers/go/v1.8/assets/link.svg)
This release adds no new features.