For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu

MongoDB Compass Release Notes for 2023

Note

Archived release notes

This page lists 2023 releases for historical reference. To see the most recent releases, see MongoDB Compass Release Notes and Changelog.

Released December 18, 2023

New Features:

  • Auto-insert empty document for all fields in the query bar.

  • Add filter to saved connections when there are more than ten saved (COMPASS-7439).

  • Implement text search for aggregation stage wizard.

  • Improve stage wizard discoverability and interaction (COMPASS-7350).

  • Use dark colors for background on initial app loading with dark theme.

  • Remove outdated guide cues (COMPASS-7396)

  • Introduced workspaces plugin and implemented single top-level tabs (COMPASS-7354).

Bug Fixes:

  • Include OIDC in $external auth mechanism list (COMPASS-7512).

  • Properly render syntax errors in embedded shell (COMPASS-7497).

  • Expanded documents retain state after switching tabs (COMPASS-7318).

  • Prevent shell container from overlaying sidebar content (COMPASS-7395).

  • Prevent AI entry button from being submitted when the sort is submitted (COMPASS-7356).

Full changelog available on GitHub

Released October 18, 2023

New Feature:

Bug Fixes:

Full changelog available on GitHub

Released October 11, 2023

New Features:

Bug Fixes:

  • Fixed GUI flicker when closing the search index modal (COMPASS-7248).

  • Downgraded Electron to version 25.8.4 (COMPASS-7291).

  • Corrected an error displaying collections in Atlas Data Federation through the side bar (COMPASS-7307).

  • Fixed an issue when the insert dialog did not catch invalid bson (COMPASS-7316).

Full changelog available on GitHub

Released September 28, 2023

Bug Fixes:

  • Hot fixed an issue where users were not able to run Compass after upgrading to 1.40.0 (COMPASS-7270, COMPASS-7269).

  • Repairs broken preferences by setting default values.

Full changelog available on GitHub

Released September 27, 2023

New Features:

  • When using a search index, a new tab prompts you and redirects you to the aggregation tab with the $search operator and the index name populated (COMPASS-7168).

  • Added a drop-down to choose a search index template (COMPASS-7173).

Bug Fixes:

  • Ensure Atlas Login doesn't show in settings if you didn't get the Generative AI feature rollout.

Full changelog available on GitHub

Released September 26, 2023

New Features:

Bug Fixes:

  • Account for changed key order in query (COMPASS-7194).

  • Remove out stages before running explain plan (COMPASS-7012).

  • Don't automatically select regex when detecting regex (COMPASS-7144).

Full changelog available on GitHub

Released September 6, 2023

Bug Fixes:

  • Allows [object Object] as a valid string value in TypeChecker (COMPASS-7132).

  • Doesn't treat non-numbers in CSV headers as array indexes (COMPASS-7157).

  • Limits when custom paste handling is applied and uses clipboard data when auto-fixing user input (COMPASS-7149).

  • Updates Electron to v24.8.2 to address security vulnerabilities. This updates specifically addresses CVE-2023-4427 and CWE-119.

Full Changelog available on GitHub

Released August 28, 2023

Bug Fix:

  • Fix compatibility issue for saved connections in older versions of MongoDB Compass
    (COMPASS-7141).

Released August 22, 2023

Note

Starting in version 1.39.2, MongoDB Compass no longer supports migrating from legacy connection files that pre-date version 1.31.0. Legacy connections refer to an internal Compass connection-options format that is stored on disk and no longer supported after version 1.39.0.

If you have legacy connections saved in your favorites, export the connections on version 1.39.0 to convert them into the new format before updating to version 1.39.2 or later.

New Features:

Bug Fixes:

  • Fix error that would occur when modifying a filter in the schema tab (COMPASS-6944).

  • Use correct tab name for indexes & validation (COMPASS-7022).

  • Strip unknown preferences when loading (COMPASS-7026).

  • Split connection storage between processes (COMPASS-7078).

  • Clear drop collections input state if drop collections success (COMPASS-7035).

  • Allow empty optional string flags (COMPASS-7101).

Full Changelog available on GitHub

Released August 8, 2023

New Features:

  • Updates Electron to v23.3.12 to address security vulnerabilities. The specific CVEs addressed in this update are CVE-2023-3730, CVE-2023-3732, and CVE-2023-3728.

Full Changelog available on GitHub

Released July 14, 2023

New features:

Bug Fixes:

  • Fix issue where Compass would create an incorrect index. (COMPASS-6981)

  • Ensure that Compass displays indexes in the correct case. (COMPASS-6510)

  • Cap number of log files to 100. (MONGOSH-1449)

  • Map project to projection before emitting open-explain-plan event (COMPASS-6995)

  • Fix issue with Windows hotkeys. (COMPASS-6777)

  • Handle missing execution stats in raw explain.

Full Changelog available on GitHub

Released June 30, 2023

Bug Fix:

  • Fix issue with projecting document size. (Reverts COMPASS-6837)

Full Changelog available on GitHub

New Features:

  • Auto expand object and array field types on field add (COMPASS-6939).

  • Show unindexed query insight in explain plan modal (COMPASS-6933).

  • Show array length on array fields on documents (COMPASS-6938).

  • Add ctrl + tab and ctrl + shift + tab hotkeys for switching tabs.

  • Enable new explain plan by default.

  • Adds insights for usage of $text and $regex in aggregation builder and collection header (COMPASS-6834).

  • Add cues (COMPASS-6614).

  • Signal for bloated documents during import.

Full Changelog availble on GitHub

Released June 21, 2023

New Features:

  • OpenID Connect (OIDC) authentication (COMPASS-6803).

  • Stage wizard, which helps build aggregation pipelines (COMPASS-6814).

  • Add visual tree and update summary for aggregation explain plans (COMPASS-6821 and COMPASS-6888).

  • Open a collection in a new tab shortcut.

  • Add performance tab indicator to state that information about certain collections is missing (COMPASS-6593).

  • Add Atlas error message when connection fails because of IP access issue (COMPASS-6842).

  • Show insight when query is unindexed (COMPASS-6832).

  • Show insight when number of collections is too high (COMPASS-6835).

  • Add unindexed aggregation insight (COMPASS-6833).

  • Implement guide cue component in Compass to provide contextual user interface assistance (COMPASS-6334).

  • Add support for hiding and unhiding indexes in the Index tab.

  • For Windows installations, Compass now requires Windows version 10 or later (COMPASS-6897).

Bug Fixes:

Full Changelog available on GitHub

Released May 25, 2023

New Features:

  • Dark mode has been updated with a modern theme. If the modern theme is enabled in Settings>Feature Preview, Compass defaults to the modern dark mode theme.

  • Various user experience improvements when using the Import and Export functionality in Compass (COMPASS-5576, COMPASS-6543).

  • Combine array fields into one in the import CSV preview (COMPASS-6766).

  • Add settings to sidebar menus (COMPASS-6796).

  • Show password only when user focuses on input (COMPASS-6161).

  • Add autocomplete support for $percentile, $median and $$USER_ROLES (COMPASS-6780, COMPASS-6781).

  • Toggle state of Edit connection string is based on the new global preference. This setting controls whether a password is visible when creating a new connection.

  • Compass supports the new Queryable Encryption protocol. Starting in v1.37.0, Compass is not compatible with MongoDB server versions earlier than 7.0 when using Queryable Encryption (COMPASS-6601, COMPASS-6602).

    • When using queryable encryption on pre-7.0 servers, you can decrypt encrypted data, but you cannot insert or query data.
  • Add export aggregation code preview to export modal (COMPASS-6725).

Bug Fixes:

  • Differentiate between new Date() and Date() (COMPASS-6755).

  • Fix guessFileType() when JSON fails and CSV lines are huge.

  • Flush import progress throttle on import error.

  • Feature flag default values (COMPASS-6525).

  • Allow updates on a sharded collection (COMPASS-6058).

  • Detect line breaks, pass it on to papaparse (COMPASS-6819).

  • Update reset on query bar to reset results and emit query-changed (COMPASS-6805).

Full Changelog available on GitHub

Released April 27, 2023

New Features:

Bug Fixes:

Full Changelog available on GitHub

Released April 13, 2023

New Features:

  • Add links to the documentation to the agg and stage autocompleter suggestions (COMPASS-6688)

Bug Fixes:

Released March 29, 2023

New Features:

Bug Fixes:

  • Apply readPref to initial ping command (COMPASS-6595)

  • Fix guessFileType() for large JSON docs (COMPASS-6629)

  • Fix memory leak in listCSVFields() (COMPASS-6630)

  • Add dark mode colours for the mixed warning

  • Abort analyzeCSVFields() when closing the import modal (COMPASS-6633)

  • Optimize CSV field type detection

Full Changelog available on GitHub

Released March 15, 2023

New Features:

Bug Fixes:

  • If a date is in the safe range, go with relaxed EJSON rather than canonical (COMPASS-5744)

  • Redesign of add stage button (COMPASS-6449)

  • Optimises the opening of tab

  • Don't show negative count on delete when no document count (COMPASS-5996)

  • Stop on errors when stopOnErrors is true (COMPASS-6518)

  • Undefined rather than false if getCloudInfo fails, support SRV URIs (COMPASS-6111)

  • Cancel edit on non-existent field (COMPASS-6505)

  • Halt autoupdater on application exit to prevent logger crashing (COMPASS-6051)

  • Do not reset stage value if it was already changed (COMPASS-6584)

Full Changelog available on Github:

Released January 11, 2023

New Features:

Bug Fixes:

  • Improve table view interactions

  • Do not save auto-connection in recents (COMPASS-6290)

  • Check for root level when deciding if _id key is editable (COMPASS-6160)

  • Fix the saved pipelines popover's scrolling (COMPASS-6277)

  • Disable deprecation warnings in production (COMPASS-6322)

  • Ignore non-digits in number input (COMPASS-6326)

  • Speed up export (COMPASS-6332)

  • Increase compass schema value bubble contrast (COMPASS-6230)

  • Fix macOS protocol handler connection string passing

  • Fix typo on Indexes screen

  • Avoid race condition when installing listeners

  • Hide delete for db/coll cards in readonly mode (COMPASS-6292)

  • Freeze settings modal height and adjust categories (COMPASS-6325)

  • Fix nested field autocomplete (COMPASS-6335)

  • Reset contains error check on document json view edit cancel (COMPASS-6059)

  • Pass the preference as a prop when nesting Field (COMPASS-6363)

  • Hide add stage in toolbar (COMPASS-6373)

  • Make $out options more clear in agg pipeline builder (COMPASS-6304)

  • Speed up document json view (COMPASS-6365)

  • Export to Language (Java) has incorrect class name (COMPASS-6159)

  • Enable next page button when count is unknown (COMPASS-6340)

  • Initialize before identify and use get-os-info from npm

  • Output stage destination name (COMPASS-6407)

  • Set width of compass shell to avoid overflow (COMPASS-6411)