Release Notes

MongoDB Compass 1.21

Released April 28, 2020

MongoDB Compass 1.20

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.


When you update MongoDB Compass to version 1.20, you will need to allow access to your system storage for each item in Recents and Favorites. This should be the last update that requires you to enter your keychain password.

MongoDB Compass 1.19

Released August 11, 2019

MongoDB Compass 1.18

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.

MongoDB Compass 1.17

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.

MongoDB Compass 1.16

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.

MongoDB Compass 1.15

Released August 23, 2018

MongoDB Compass 1.14

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.

MongoDB Compass 1.13

Released May 3, 2018

MongoDB Compass 1.12

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.

MongoDB Compass 1.11

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.

MongoDB Compass 1.10

Released Oct 25, 2017

MongoDB Compass 1.9

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.

MongoDB Compass 1.8

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

MongoDB Compass 1.7

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.

MongoDB Compass 1.6

Released Mar 1, 2017

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

MongoDB Compass 1.5

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.

MongoDB Compass 1.4

Released Nov 1, 2016

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

MongoDB Compass 1.3

Released Sep 15, 2016

1.3.0-beta.3 - July 12, 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.

1.3.0-beta.2 - June 29, 2016

  • Bug: Small Bug Fixes identified at MongoDB World

1.3.0-beta.0 - June 27, 2016

  • 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

MongoDB Compass 1.2

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

1.2.0-beta.3 - June 23, 2016

  • 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

1.2.0-beta.2 - June 1, 2016

  • 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

1.2.0-beta.1 - May 10, 2016

MongoDB Compass 1.1

Released Jan 19, 2016

1.1.1 – Jan 19, 2016

MongoDB Compass 1.0

Released Dec 7, 2015

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

1.0.1 – Dec 18, 2015

Bug Fixes

  • Query builder bug in unique minicharts when resetting
  • Hang: Do something graceful after closing/opening laptop lid & using Compass again
  • Error in
  • 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