Dashboards are a feature that allows you to publish graphs and visualizations and share them in a presentation format with others in your organization. This notebook will walk you through how to create, manage, and deploy dashboards.

A user creates a dashboard that consists of cells with output. Let’s create some for the dashboard we’re going to be building.

The easiest way to get started with Dashboards will be to check out the Example Dashboard Notebook.

Creating a Dashboard

Now that we have some elements to display, let’s create a dashboard from them.

To create a dashboard, navigate to the top and to the “View:” menu. From that dropdown select “+ New Dashboard”.

dashboard demo

After that you can give your dashboard a name. By default the new dashboard will include all cells that you’ve created thus far. Here’s what my current example looks like.


I can re-arrange and reshape the each cell as I see fit. We’ll cover more of that below but once I’ve created that I can now navigate back to my code by selecting the code option from the menu.


Adding Graphs to a Dashboard

If you navigate back to the dashboard view, you will notice that new cells will not automatically appear on our dashboard. We have to add them manually. We can do that in the menu at the far right (that shows the dashboard icon).


You are able to add and remove cells in this same manner. I’ve created two more graphs below and I will use those in my new dashboard. Now that we’ve created our dashboard we can go about organizing it. We can navigate up to the top to our new dashboard. Once inside of there, we can select the bottom left or right corners to resize and reshape each tile in the dashboard. You’ll see that our markdown cells have now become our labels for each section of the dashboard as well.


Publishing a Static Dashboard

You can present dashboard by selecting the button on the right.


Automatically Refreshing a Dashboard with a Job

Dashboards will not live refresh by default when you go to present them from the dashboard menu. If you want a dashboard that will refresh at a certain interval, you need to use the ‘last successful run’ page of a job that is scheduled to run at the interval you want. Go to the job’s page and click the “Last successful run (refreshes automatically)” link.

This will give you a dashboard that will update whenever the job runs! This is awesome for company level dashboards to keep the entire team informed.

Example Dashboard Notebook

Editing A Dashboard

Edit a dashboards from within the Dashboard view menu. Simply open the dashboard you would like to open and edit it as instructed above.

Deleting a Dashboard

Delete a dashboard from within the Dashboard view menu. Simply open the dashboard you would like to delete and press the delete button on the right.