A dashboard is Datadog’s tool for visually tracking, analyzing, and displaying key performance metrics, which enable you to monitor the health of your infrastructure.

Dashboard list

Search, view, or create dashboards and lists on the Dashboard List page. By default, this is the landing page after you login to Datadog. To change the default landing page for your organization, contact Datadog support.

New list

To create a dashboard list, click on the New List + button in the upper right.

The list’s title is automatically set with the user’s first name. For example, if John Doe creates a dashboard, the default title is John's list. To change a list’s title, click on the title for the text to become editable.

To add dashboards to a list, select their corresponding check boxes in the main Dashboard list. Then click on the Add to List button in the upper right corner of the Dashboard list:


The left sidebar displays favorite, preset, and shared, editable lists. You can hide this sidebar using the Hide Controls link.

Favorite lists

Favorite lists are dashboard lists starred by the current logged in user. Note: If you have no starred lists, the Favorite Lists category is hidden.

Preset lists

Preset lists are default dashboard lists in Datadog:

All CustomCustom dashboards made by any team member in your organization’s account.
All HostsAutomatic dashboards created by Datadog when you add a host.
All IntegrationsAutomatic dashboards created by Datadog when you install an integration.
Created By YouCustom dashboards created by the currently logged in user.
Frequently Viewed By YouAll dashboards frequently viewed by the currently logged in user.

Shared, editable lists

This section displays shared, editable dashboard lists with the number of dashboards in each list.

All dashboards

All dashboards listed are sortable using the column headers Star, Name, Modified, and Popularity. All columns with descriptions are listed below:

StarAll dashboards starred by the currently logged in user.
IconAn icon indicating the type of dashboard (timeboard or screenboard).
NameThe name of the custom or preset dashboard.
ModifiedThe last modified date of a custom dashboard.
PopularityThe relative popularity of the dashboard for your organization.
CreatorThe profile icon of the dashboard’s creator. Preset dashboards use the integration logo.


An organization’s most popular dashboard displays five popularity bars. All other dashboards are relative to this dashboard. Popularity is based on the amount of traffic a dashboard receives. Popularity is updated daily; new dashboards have zero popularity bars for up to 24 hours.

Note: Traffic to public dashboard URLs is ignored for popularity.

New dashboard

To create a dashboard, click on the New Dashboard + button in the upper right. Enter a dashboard name and choose between creating a timeboard or a screenboard.

Screenboard vs. timeboard

Datadog offers two types of dashboards: screenboards and timeboards. To more clearly understand the differences between the two, consider the following:

Time scopeAll graphs share the same time scope.Graphs can have individual time scopes.
LayoutGraphs are displayed in a fixed grid.Graphs are placed anywhere on the canvas.
Share graphs individuallyYesNo
Share the entire dashboardYesYes
Sharing can be read-onlyYesYes

Copy / import / export

From an individual dashboard, you can copy, import, or export a dashboard’s JSON using the settings cog (upper right) with the following options:

Copy dashboard JSONCopy the dashboard’s JSON to your clipboard.
Import dashboard JSONPaste or import your JSON to the dashboard. This option overwrites all content on the dashboard. If the JSON is already on your clipboard, use Ctrl V (Cmd V for Mac).
Export dashboard JSONDownload a JSON file containing the JSON of your dashboard.

Suggested dashboards and active users

From an individual dashboard, Datadog offers suggestions for viewing related dashboards. To view suggested dashboards and active users, click on the caret icon next to the dashboard title. These dashboards are recommended based on the user activity in your organization and how often users go from this dashboard to other existing dashboards. You can also add or update Markdown-supported dashboard descriptions in this view by clicking edit.

Restrict access

RBAC restrict access to dashboards is currently in beta. To request access, contact Datadog support.

Click the settings modal for the whole dashboard, and select Permissions. Use the pop up to restrict access to you, everyone in your org with your role, or to specific roles in your org. For more information about roles, see the RBAC documentation.

Further Reading