Delete Dashboard / Folder
This page explains removing a dashboard or folder from the Atlas module via the Delete action. Delete is irreversible; if public links are active, you may need to notify external stakeholders before deleting.
Irreversible Action
Once delete is confirmed, the dashboard is removed from the database. Layout, shares, and public tokens are fully deleted.
1. Find the Dashboard
Click Atlas in the left menu. Find the dashboard or folder you want to delete.
2. Dependency Check
Things to check before deleting:
| Dependency | Where You See It |
|---|---|
| Active user shares | Left panel of the share dialog |
| Active public links | Right panel of the share dialog |
| Embedded pages | Manual tracking — not visible in the UI |
If Embed / Public Link is Active
If the dashboard is embedded in a customer portal or conference page, deletion immediately breaks the embed pages. Notify stakeholders first or prepare an alternative dashboard.
3. More Menu → Delete
Click the More button on the right of the dashboard card → click Delete. The backend calls the delete_dashboard API.
4. Confirmation Dialog
Confirm the delete action in the dialog.
| Option | Result |
|---|---|
| Cancel | Dialog closes, dashboard preserved |
| Delete | Dashboard is removed |
Success
On successful deletion, the Atlas list updates immediately.
5. Folder Deletion
Before deleting a folder, verify it is empty. If the folder contains dashboards or sub-folders, deletion is blocked. The backend delete_atlas_folder API enforces a content check.
Folder Contents
Before deleting a non-empty folder, move the dashboards to other folders → Move.
6. Effect of Deletion
| Affected | Behavior |
|---|---|
| Cartography widgets | Unaffected — they are independent records |
| Compass queries | Unaffected |
| User shares | Auto-removed |
| Public links | Immediately return 403 |
| Embedding pages | iframe goes blank or shows an error |
7. Common Errors
| Symptom | Possible Cause | Solution |
|---|---|---|
| Delete button is disabled | You are not the owner | The owner has delete permission |
| "Cannot delete: dashboard is in use" | Active share or public link | Remove shares/links first |
| Folder will not delete | Folder is not empty | Move the contents |
| Error on embedding page after deletion | Public token disabled | Update the embedding page |