Docs Menu


On this page

  • Dashboards Tab
  • Create a New Dashboard
  • Refresh Dashboard Data
  • Fullscreen View

Dashboards are a collection of charts assembled to create a single unified display of your data. Each chart shows data from a single MongoDB collection or view, so dashboards are essential to attain insight into multiple focal points of your data in a single display. Dashboards can be shared with other users.

The Dashboards tab shows all dashboards you have access to view. To learn more about dashboard permissions in MongoDB Charts, see Dashboard Permissions.

Charts Dashboard Tab

Each dashboard shows the following information:

  • Title
  • Description
  • A preview of the first three charts in the dashboard, including the chart title and type
  • When the dashboard was last modified

By default, the most recently modified dashboards are shown first in the list. You can change the sort order by using the Sort By dropdown menu.

To create a new dashboard:

  1. From the Dashboards tab, click the New Dashboard button.
  2. In the New Dashboard dialog, enter a title for your dashboard.
  3. (Optional) Enter a description for your dashboard.
  4. Click Create.

After after clicking the Create button you are taken to the page for your newly created dashboard, where you are prompted to add the first chart to your dashboard:

Charts New Dashboard Example

You can refresh dashboard data to update all charts on the dashboard with the most current data from their respective data sources. When MongoDB Charts loads charts on a dashboard, it does not consistently query the data source for each chart. Instead, MongoDB Charts queries the data source when the dashboard first loads, and that data is stored in the browser cache and used to render the charts.

MongoDB Charts provides options to both manually refresh dashboard data and configure the dashboard to automatically refresh at a specified time interval. These options allow you to control how current the data displayed on your dashboard is. By default, when you first create a dashboard, it is configured to refresh its data every hour. The Auto text next to the icon signifies that auto refresh is enabled.

To manually refresh dashboard data, first select a dashboard from the Dashboards tab, then click the button at the top-right of the dashboard.

You can configure auto refresh settings to change the interval at which the dashboard data is refreshed. The dashboard shows the time its data was last updated and when the next update will occur at the top-right of the view.

To configure auto refresh settings for a dashboard:

  1. From the dashboard view, click the arrow next to the button and click Auto Refresh Settings.
  2. Select the desired refresh interval.
  3. Click Save.

Auto refresh settings are stored in the local browser state. Settings dictating whether auto refresh is enabled and its configured interval are not persisted with the dashboard or shared with other users.

To disable auto refresh, click the arrow next to the button and click Disable Auto Refresh.

To enable auto refresh, click the arrow next to the button and click Enable Auto Refresh.

MongoDB Charts provides a fullscreen view for dashboards. In this view, MongoDB Charts hides the main navigation bar and exapands the dashboard to show the title, description, time of last modification, and charts in the entire space of the screen.

To open a dashboard in fullscreen view, first select a dashboard from the Dashboards tab, then click the expanding arrows at the top-right of the dashboard:

Fullscreen Arrows

You can still remove, resize, rearrange, and access editing for charts in fullscreen view by hovering over the desired chart.

Additionally, in fullscreen view you can still configure auto-refresh settings and manually refresh chart data using the refresh button.

To exit fullscreen view, either click the contracting arrows at the top-right of the dashboard or press the escape key.

Give Feedback
© 2021 MongoDB, Inc.


  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.