MongoDB Go Driver 2.0 is Here! Ready for Production

Julia_Tazin · 2025-01-16T18:55:43.444Z

The MongoDB Go Driver 2.0 is Here and Ready for Production!

We’re excited to announce the official release of MongoDB Go Driver 2.0! A sincere thank you to all the developers who provided invaluable feedback during the beta phase.

What’s New in 2.0?

Version 2.0 brings several enhancements designed to improve your development experience:

Simplified Client Side Operations Timeout (CSOT) experience
OpenID Connect (OIDC) support
Cleaner, more idiomatic Go code
- More descriptive and actionable error messages
- A simplified package structure for easier navigation
- A streamlined interface for improved usability

Explore the full release notes: MongoDB Docs

Impact on Older Versions

New features will no longer be added to the 1.x versions. Critical bug fixes and security patches will continue to be backported to 1.x versions until January 15, 2026. After this date, support for 1.x versions will be discontinued.

How to Upgrade to 2.0

Ready to upgrade? Our migration guide provides detailed instructions to help you navigate the transition. Comprehensive documentation is also available on pkg.go.dev.

Questions? Feedback?

We’d love to hear from you! Share your questions and feedback on the MongoDB Community Forums, and don’t forget to tag them with “golang.”

Happy coding!

The MongoDB Go Driver Team

Jack_Woehr · 2025-01-18T01:00:54.756Z

image1024×1024 70.1 KB

Jack_Woehr · 2025-01-18T23:02:10.335Z

Is there an updated tutorial example, or just the migration guide?

Julia_Tazin · 2025-01-21T14:47:46.213Z

Hi @Jack_Woehr, are you looking for a tutorial/example on something specific?

All of our documentation is kept up-to-date for each version (you can select the needed version in the dropdown at the top left). Our documentation includes multiple tutorials and code examples.

Jack_Woehr · 2025-01-22T15:22:44.560Z

Ah, I see the updated Quick Start now. Thanks

Julia_Tazin · 2025-01-22T16:28:09.402Z

Great! @Jack_Woehr, let me know if anything else is needed!

Jack_Woehr · 2025-01-22T18:55:37.407Z

@Julia_Tazin, the quickstart example you point to seems to be incorrect for V2.
When I try to run the given code I get:

$ go run main.go
main.go:11:2: no required module provides package go.mongodb.org/mongo-driver/bson; to add it:
	go get go.mongodb.org/mongo-driver/bson
main.go:12:2: no required module provides package go.mongodb.org/mongo-driver/mongo; to add it:
	go get go.mongodb.org/mongo-driver/mongo
main.go:13:2: no required module provides package go.mongodb.org/mongo-driver/mongo/options; to add it:
	go get go.mongodb.org/mongo-driver/mongo/options

If I try to add any of those packages, it pulls in the v1.17.2 driver

$ go get go.mongodb.org/mongo-driver/bson
go: added go.mongodb.org/mongo-driver v1.17.2

Julia_Tazin · 2025-01-22T19:45:00.611Z

@Jack_Woehr Thanks for pointing this out, we’re updating the documentation.

Julia_Tazin · 2025-03-04T17:21:45.710Z

Hi @Jack_Woehr – we have updated our Go Driver Quick Start for v2.

Jack_Woehr · 2025-03-04T17:55:08.078Z

WFM, thanks, @Julia_Tazin

system · 2025-04-16T18:56:15.171Z

This topic was automatically closed after 90 days. New replies are no longer allowed.