Docs Menu

Docs HomeMongoDB Compass

Interface Settings

On this page

  • Settings Panel Location
  • Settings
  • Learn More

You can customize MongoDB Compass to meet your specific needs on the Compass interface. Some options are only available in the Settings panel.

If you have already configured Compass settings on the command line or in a configuration file, you cannot modify those settings in the Compass interface.

To find the Compass Settings panel, open the MongoDB Compass system menu and select Settings.

Settings panel location under the MongoDB Compass system menu

You can also open the the Compass Settings panel when connected to your cluster by doing the following:

  1. Click the next to your cluster name.

  2. Select Compass Settings from the dropdown.

Alternatively, you can use keyboard shortcuts to open the Settings panel:

  • Windows / Linux: Ctrl + ,

  • Mac: + ,

You can configure the following settings on the MongoDB Compass interface:

Setting
Category
Definition
Set Read-Only Mode
General

Remove all write and delete capabilities on Compass.

To learn more, see Restrict Write Operations to MongoDB.

Enable MongoDB Shell
General

Enable or disable the embedded MongoDB Shell on Compass.

If you select Set Read-Only Mode, Compass automatically disables the Enable MongoDB Shell setting.

To learn more, see Disable the Embedded MongoDB Shell.

Protect Connection String Secrets
General

Sets all connection strings as read-only. Passwords in connection strings display as *****.

If protectConnctionStrings is enabled, Compass disables the Edit connection string option and hides the Edit connection string toggle.

To learn more, see Hide Credentials in Your Connection String.

Show Kerberos Password Field
General

Show or hide the Kerberos password field on the Compass connection form.

To learn more, see Display the Kerberos Password Field.

Upper Limit for maxTimeMS for Compass Database Operations
General
Specify an upper time limit for all Compass database operations.
Enable DevTools
General

Enable Chrome DevTools.

To learn more, see Toggle Chrome DevTools.

Install Compass as URL Protocol Handler
General

Register Compass as a handler for mongodb:// and mongodb+srv:// URLs.

If Install Compass as URL Protocol Handler is enabled, you can open Compass by navigating to a mongodb:// or mongodb+srv:// URL in your browser.

By default, Install Compass as URL Protocol Handler is enabled. You cannot toggle this option on Linux. You can toggle this setting only on Windows or macOS.

Sync with OS
Theme
Automatically switch between light and dark themes based on your OS settings.
Light Mode
Theme
Use a light theme.
Dark Mode
Theme
Use a dark theme.
Enable Automatic Updates
Privacy
Allow Compass to periodically check for new updates.
Enable Geographic Visualizations
Privacy
Allow Compass to make requests to third-party mapping services.
Enable Usage Statistics
Privacy
Allow Compass to send anonymous usage statistics.
Give Product Feedback
Privacy
Allow our Product team to occasionally reach out for feedback about Compass.
Enable AI Features
Privacy
Allows the use of AI features in Compass which make requests to 3rd party services.
Browser command to use for OIDC Authentication
OIDC
Specify the browser that Compass redirects you to when authenticating with the identity provider.
Show Device Auth Flow Checkbox
OIDC
Show a check box on the connection form to enable the device authentication flow. This provides the option to enable a less secure authentication flow as a fallback when browser-based authentication is unavailable.
Stay logged in with OIDC
OIDC
Remain logged in when using the MONGODB-OIDC authentication mechanism.
Use Generative AI
Feature Preview
←  Customize CompassCommand Line Options →