Import & export Custom Dashboards
Effortlessly share your custom dashboards within your organization by importing and exporting them, eliminating the need to recreate them and minimizing overhead.
Import a custom dashboard
In the Dashboards List, select Import.
In the popup that appears, select a .json file to upload or paste your copied JSON. If you want to place the imported dashboard in a specific folder, pick one from the folder selector.
The optional Slug field sets the dashboard's custom URL identifier. If the JSON includes a slug, the field is filled in with it. Change or clear the value as needed.
Select Next.
Review the dashboard summary on the confirmation step, and then select Import to add it to your catalog. The new dashboard is named after the original, with (imported) appended.
To revise your input before confirming, select Back to return to the previous step, your uploaded file, pasted JSON, and folder selection are preserved.
A slug can contain only lowercase letters, numbers, hyphens (-), and underscores (_), and can't start or end with a hyphen or underscore. It must also be unique within your team. If another dashboard already uses the slug, for example the dashboard you exported the JSON from, the field shows This slug already exists, choose a different name. and Next stays unavailable until you change it. To import the dashboard without a custom slug, clear the field.
Export a custom dashboard
Open the Export menu from either of these locations:
- The more actions menu on a dashboard card in the catalog.
- The Export button in the dashboard header.
Both menus offer the same three options:
- Download as PDF: downloads the dashboard as a PDF file. For format and layout options, see Save a dashboard as a PDF.
- Download as JSON: downloads the dashboard definition as a JSON file.
- Copy JSON to clipboard: copies the dashboard JSON to your clipboard.
When the dashboard has changes you have not saved, both JSON options show an Includes unsaved changes note, and the exported JSON reflects what is currently on screen.
Download as JSON and Copy JSON to clipboard are unavailable for dashboards that have not yet been saved.
The exported JSON includes the dashboard's custom URL slug, if one is set. When you import the JSON, or use it to replace a custom dashboard, the Slug field is filled in with that slug. If you import into the same team as the source dashboard, change the slug or clear the field before you continue.
Additional resources
| Documentation | Custom Dashboards |
Next steps
Learn how to replace a custom dashboard in place by importing JSON.