Quick Guide
Open Dashboard Builder in Samurai to follow this guide.
You build Dashboards in Dashboards → Dashboard Builder, and viewers open published ones in Dashboards → Custom Dashboards. Your role decides which of create, edit, publish and delete you can do.
Create a Dashboard

Select Create new dashboard in Dashboard Builder to start the setup steps below.
- In Dashboard Builder, select Create new dashboard.
- Enter a Dashboard name and an optional Description.
- Under Start from template, choose Blank dashboard or a template, then select Continue.
- Select Add Widget, search the picker, and add a dataset.
- Drag widgets to arrange them, and drag a tile's resize handle to size it.
- Select Save Dashboard.
Save a Dashboard
Autosave is on by default and saves your draft shortly after each change. Viewers see those changes only when you publish again. Turn it off with the Autosave switch beside Save Dashboard. It stays off until you next open the Dashboard. The status shows Saved, Unsaved changes or Save failed, with Retry save. If you leave with unsaved changes, choose Keep editing, Discard changes or Save and leave.
Edit a Dashboard
Open the Dashboard and switch to Editing Mode. Use the ... menu on a widget for these actions:
| Action | What it does |
|---|---|
| Configure widget | Sets the title, columns, filters, sorting, grouping and period. Changes apply when you select Apply changes. |
| Change chart type | Switches the widget's presentation. |
| Refresh data | Reloads the widget's data. |
| Export to Excel or CSV | Downloads the widget's data. |
| Copy widget | Adds a copy beside the original, with the same settings and (copy) after its title. |
| Remove widget | Removes the widget. With Autosave off, it goes when you next save. |
Use Preview Mode to check the Web and Mobile layouts. Dashboard filters narrow every widget that supports them, and they can never widen what a widget or user can see.
Publish a Dashboard
Publishing creates a read-only snapshot of the Dashboard's design. Widget data stays live, but later design changes reach viewers only when you publish again.
- Select Publish in Preview Mode, or use the arrow beside Save Dashboard in Editing Mode. Unsaved changes are saved first.
- Under Who can see it, choose Only Me, Specific Role(s) or Everyone.
- Select Publish.
Everyone means everyone in your tenancy. Each viewer sees only the data their own permissions allow, so two viewers can see different numbers on the same Dashboard.
To withdraw a shared Dashboard, publish it again with Only Me.
Delete a Dashboard
Select the delete icon on the Dashboard's card in Dashboard Builder, then confirm. Deleting is permanent and also removes the published snapshot, so viewers lose access immediately. You can delete only Dashboards you own.
To see what each chart can do, see Widget and Chart Options.