Navigation

    Release Notes

    Released November 4, 2020

    • Notarizes MongoDB Compass for macOS Catalina. You should no longer need to manually allow macOS to trust MongoDB Compass before running.
    • Kerberos authentication improvements on RHEL7.
    • Importing a text pipeline containing a $out stage no longer crashes MongoDB Compass.
    • Various other bug fixes and improvements

    Released September 3, 2020

    • Added an embedded MongoDB Shell. You can use MongoDB Shell to test queries and operations in an interactive JavaScript interface.

    Released April 28, 2020

    Info With Circle IconCreated with Sketch.Note

    On macOS systems, the first time that you update MongoDB Compass to version 1.20 or later, you will need to allow access to your system storage for each saved connection in Recents and Favorites. To learn more, see Allow Keychain Access for Recent and Favorite Connections.

    Released December 5, 2019

    • Added the option to include driver syntax when exporting queries to a language.
    • New and improved Connection experience with support for all connection options.
    • Improved user experience for saving and sharing Favorite Connections.
    • Added JSON mode for managing documents. With JSON mode, you can now insert multiple documents at once.
    • Added support for querying UUIDs via the Documents query bar or in the Aggregation Pipeline Builder.
    • Added support for the following aggregation pipeline operators:

    • Improved inline documentation for aggregation pipeline arguments.
    • Removed $limit ahead of the $count stage in the aggregation pipeline builder to ensure accurate counts on large collections. Prior versions of MongoDB Compass placed a $limit stage before $count stages in the Aggregation Pipeline Builder for large collections, even when sample mode was disabled.
    • Various bug fixes and improvements.

    Released August 11, 2019

    Released May 17, 2019

    • Provided fixes to the Compass Windows installer. With the new .msi installer you can:

      • Select the destination of the Compass installation.
      • Install Compass for all users.
      • Script the Compass installation and perform a quiet install.
    • Added support for Ubuntu 18.10 and other recent Linux distributions.
    • New Schema Validation experience.

    • For macOS systems, Compass now requires macOS 10.12 or greater.

    Released March 4, 2019

    • Performance improvements to the Documents and Aggregation tabs, specifically with deeply nested documents.
    • Fixed several connection issues.

      • Fixed Kerberos connections where hostname is not the canonical name.
      • Fixed SRV connections with special characters in the password.
      • Compass no longer allows direct connections to secondary databases, which would result in hangs on the loading navigation screen.
      • Fixed connections to M0 Atlas clusters with readonly users.
    • Fixed issue where usersInfo command was not available to the data service.
    • authSource now correctly defaults to admin when connecting to Atlas.
    • Compass now properly forces a disconnect when requested.

    Released November 12, 2018

    • Added collation support to the following features:

    • Added the ability to find text within a page using either Ctrl + F or Command + F, depending on your platform.
    • Reduced the required permissions to use MongoDB Compass. As of this version of MongoDB Compass, users require the read permission to access a database in Compass.
    • Updated dates to display in UTC time.
    • Added support for SCRAM-SHA-256 authentication mechanism.
    • Various bug fixes and improvements.
    • As of this version, you should not provide a Password when using Kerberos as the authentication mechanism.

    Released August 23, 2018

    Released June 26, 2018

    • Added Aggregation Pipeline Builder, which provides the ability to execute aggregation pipelines to gain additional insight into your data.
    • Added MongoDB Compass Isolated Edition for highly secure environments. This edition does not initiate any network requests except to the MongoDB server.

    Released May 3, 2018

    Released March 5, 2018

    • Added MongoDB Compass Readonly Edition which limits certain CRUD operations within your organization.

      The following actions are not permitted in Compass Readonly Edition:

      • Create and drop databases
      • Create and drop collections
      • Create, delete, edit and clone documents
      • Create and drop indexes
      • Create, delete and edit document validation rules

      All other functionality remains the same as in standard MongoDB Compass.

    • Added support for connecting to Compass using an SRV record . In the connect dialog, if Compass detects an SRV record URI on the clipboard it auto-completes the dialog based on the SRV record.
    • Made various performance and stability inprovements to the documents tab.

    Released December 17, 2017

    • Added support for plugins that extend the functionality of MongoDB Compass.
    • Added support for disconnecting from the active MongoDB instance without restarting MongoDB Compass.
    • Added Table View for documents as a method of viewing the contents of a collection in tabular format.

    Released Oct 25, 2017

    Released Oct, 2017

    • Added autocomplete functionality to the query bar.
    • Query History
      Compass automatically stores up to 20 most recent queries for each collection. From the past queries view for a collection, you can view the recent queries as well as the queries saved as favorites . For more information, see View Past Queries.
    • Deployment Awareness
      When a user connects to a MongoDB instance, Compass now displays:
      • The connection name if the connection is a favorite connection or "My Cluster" if it is not.
      • The type of deployment (standalone, replica set, sharded cluster). If the deployment is a replica set and the replica set name is specified in the connection window, the number of replica set members will also be displayed.
      For more information, see Compass Home.

    Released Aug 2, 2017

    • Documents tab is the default
    • Schema sampling only on demand
    • Explain executed only on demand
    • Improved Document Editing
    • Deployment Awareness (and read preference)

      • Added ability to specify replica set name and read preference in connection screen.
      • Added ability to parse MongoDB URI string in the connection screen.
    • Allow typing index field names in addition to dropdown
    • Use Client Meta Data to identify Compass application name in server logs
    • New Loading animation

    Released Jun 7, 2017

    • Added ability to include options in the query bar.
    • Added ability to add or delete database/collection from the left-hand navigation sidebar.
    • Added ability to collapse the left-hand navigation sidebar.

    Released Mar 1, 2017

    • Added support for Linux: Ubuntu 14.04+ and RHEL 7+.
    • Added ability to zoom in and zoom out of panels.

    Released Nov 29, 2016

    • Added ability to create and drop databases.
    • Added ability to create and drop collections.
    • Added ability to create indexes.
    • Added support for document validation.
    • Improved security when connecting to Atlas. During Connection setup, MongoDB Compass supports the use of System Certificate Authority for TLS/SSL connections to Atlas Deployment.
    • Provides Real Time Performance stats.

    Released Nov 1, 2016

    • Add support for connecting to Atlas.
    • Various bug fixes and improvements.

    Released Sep 15, 2016

    • Allow specifying the value of the _id field when inserting new documents.
    • Set the default field and value sizes to 1 when adding a new key to a document.
    • Typing ":" in the key input field tabs to the value input field when editing a document.
    • Only allow addition of one element at a time if the field name in the new element is blank when editing a document.
    • CRUD documentation now available in the application help menu.
    • Fix element autofocus on add.
    • Bug: Small Bug Fixes identified at MongoDB World
    • New: CRUD single document create, update, delete
    • New: SSH tunnel support
    • New: Tree explain plan view
    • New: Geographic query builder and visualization
    • Explicit opt-in for "3rd party maps" usage
    • Improve display of binary data in in the document viewer
    • Query builder on numeric histograms should leave bounds open
    • Intercom overlay button now visible
    • Load preferences defensively, catching parsing errors and reset preferences
    • Compass Treasure Hunt for MongoDB World

    Released Jun 27, 2016

    • Beta installs alongside the stable release as a distinct application, with distinct preferences
    • Index view
    • Explain plan view
    • Documents view moved to a separate tab
    • Automatic updates
    • Bug: Feature Tour does not show on first launch
    • Bug: Compass fails to start with JavaScript error in main process: SyntaxError: Unexpected end of input
    • Bug: No error displayed message when an authentication error occurs
    • Bug: Compass does not handle $indexStats fetch failure on MongoDB 3.2
    • NEW: Added explain plan view
    • Added feature tour points of new 1.2 features
    • Bugfix: After increasing maxTimeMS timeout, query default falls back to 100 docs

    Released Jan 19, 2016

    Released Dec 7, 2015

    MongoDB Compass 1.0 is now available. It helps users to visually analyze and understand their MongoDB data.

    • Query builder bug in unique minicharts when resetting
    • Hang: Do something graceful after closing/opening laptop lid & using Compass again
    • Error in Compass.app/Contents/Resources/app/node_modules/scout-server/lib/models/token.js:20
    • Pass readPreference.nearest in lib/routes/collection.js
    • Enterprise/Community version not correctly detected for MongoDB 2.6, 3.0
    • Compass hangs when upper case host alias used in connection
    • Reduce reservoir sampling limit to 10,000 documents
    • Possible race condition when reading from IndexedDB
    • Cannot access DBs with colon (":") in their name
    • Cannot read property 'authInfo' of undefined in mongodb-instance-model/lib/fetch.js:297
    • Cannot access DBs with octothorp (#) in their name
    • Failure to sample on first collection selected
    • ObjectID visualization missing last tooltip
    • Change intercom message/menu item to "Provide Feedback"
    • Open external links in user's web browser, not Electron
    • Place SSL "Client Certificate" field above "Client Private Key"
    • Re-enable highlighting/selecting of some UI elements
    • Replace Help entry stubs with actual text
    • Use consistent titles across windows
    • Simplify language in opt-in panel
    • Reduce font size of header to accommodate full db.collection name
    • Remove "–" (minimize) on Intercom
    • Run shrinkwrap to lock Compass 1.0 dependencies
    • Confirm successful Evergreen builds from release-1 branch
    • Compass fails to connect to hostname
    Give Feedback