This documentation refers to the MongoDB Charts service in MongoDB Atlas. Read the on-premises documentation to learn how to use the MongoDB Charts on site.


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.

Dashboards Tab

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.

Create a New Dashboard

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

Refresh Dashboard Data

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 sync icon icon signifies that auto refresh is enabled.

Manually Refresh Dashboard Data

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

Configure Auto Refresh Settings

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 sync icon 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.

Disable and Enable Auto Refresh

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

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

Fullscreen View

MongoDB Charts provides a fullscreen view for dashboards. In this view, MongoDB Charts hides the main navigation bar and expands 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.