Dashboards
A dashboard in CalabiIQ is a canvas of charts, text panels, and filters that tells a complete data story. Dashboards are the primary way to share insights with stakeholders and monitor key metrics at a glance.
Creating a Dashboard
Start from scratch
- In the top navigation, click Dashboards → + Dashboard.
- Enter a Title (e.g.,
Exam Performance — Q2 2026). - Click Save.
The dashboard opens in Edit mode automatically.
Start from an existing dashboard
- Open the dashboard you want to duplicate.
- Click the ··· (More) menu in the top-right → Save as.
- Give the copy a new name and click Save.
Adding Charts to a Dashboard
In Edit mode, you have two ways to add charts:
Option A — Drag from the chart panel
- Click Edit Dashboard (pencil icon, top-right).
- In the right-hand Charts panel, search for a chart by name.
- Drag it onto the canvas and drop it where you want it.
Option B — Add from the chart itself
- Open any chart in the Charts list.
- Click ··· → Add to Dashboard.
- Select the target dashboard from the dropdown and click Add.
You can create a brand-new chart from within dashboard Edit mode by clicking + New Chart in the Charts panel. This opens the Chart Editor, and when saved the chart is automatically placed on the dashboard.
Layout & Resizing
CalabiIQ uses a fluid grid layout. Every element — charts, text boxes, dividers, and headers — snaps to grid columns.
| Action | How |
|---|---|
| Move a chart | Drag the chart by its title bar |
| Resize a chart | Drag the bottom-right resize handle |
| Add a text/Markdown panel | Click + Add component → Markdown |
| Add a divider or header | Click + Add component → Divider or Header |
| Undo a layout change | Press Ctrl+Z (Cmd+Z on macOS) |
Layout changes are not saved automatically. Always click Save (top-right) when you are happy with the arrangement.
Dashboard Filters
Native filters let viewers slice every chart on a dashboard without touching individual chart queries.
Adding a filter
- In Edit mode, click the Filters icon (funnel, left sidebar) → + Add filter.
- Choose a Filter type (see Dashboard Filters for the full guide).
- Map the filter to one or more charts using Scope settings.
- Click Save.
Filter bar position
By default the filter bar appears on the left side. To move it:
- Click ··· (dashboard menu) → Edit dashboard.
- Toggle Filters on top to place the bar horizontally above the charts.
Refresh Intervals
Keep dashboards up-to-date without a manual page reload.
- Open the dashboard.
- Click ··· → Set auto-refresh interval.
- Choose an interval: 10 seconds, 30 seconds, 1 minute, 5 minutes, 30 minutes, 1 hour, or 24 hours.
- Click Save.
Short refresh intervals (< 1 minute) on complex dashboards with many charts can create significant database load. Use with caution on shared production databases.
Dashboard Actions Reference
| Action | Location | Who can do it |
|---|---|---|
| Edit layout | Edit Dashboard button | Owner, Admin |
| Save layout | Save button (Edit mode) | Owner, Admin |
| Set as Draft / Publish | Draft toggle (Edit mode) | Owner, Admin |
| Duplicate dashboard | ··· → Save as | Any viewer |
| Delete dashboard | ··· → Delete | Owner, Admin |
| Set auto-refresh | ··· → Set auto-refresh interval | Any viewer |
| Export dashboard (JSON) | ··· → Export | Owner, Admin |
| Import dashboard | Dashboards list → Import | Admin |
| Share permalink | Share button → Copy permalink | Any viewer |
| Embed dashboard | Share button → Embed code | Owner, Admin |
| Add to favorites | Star icon | Any viewer |
| Download as image | ··· → Download as image | Any viewer |
Publishing & Draft Mode
New dashboards are created in Draft mode by default. Draft dashboards are only visible to owners and Admins.
To publish a dashboard:
- Open the dashboard in Edit mode.
- Click the Draft badge next to the title.
- It changes to Published — the dashboard is now visible to all users with access.
To revert to Draft, click Published → Revert to draft.
Sharing Dashboards
Permalink
- Click the Share button (top-right of any dashboard).
- Select Copy permalink.
- Send the URL — recipients must have Calabi credentials to view it.
Embed URL
Dashboards can be embedded in external portals or internal tools.
- Click Share → Embed code.
- Configure allowed domains (comma-separated list).
- Copy the
<iframe>snippet and paste it into your target page.
<iframe
src="https://calabi.yourdomain.com/bianalyst/embedded/dashboard/<uuid>"
width="100%"
height="800"
frameborder="0"
allowfullscreen
></iframe>
Embedding requires the Professional tier. The embedded view respects all row-level security rules — users see only the data they are permitted to access.
Scheduled Email Reports
Send a dashboard screenshot to a distribution list on a schedule.
- Click ··· → Schedule email report.
- Set a Report name, Recipients (comma-separated emails), and a cron schedule.
- Choose delivery format: PNG screenshot or PDF.
- Click Add.
See Sharing & Permissions for the full email report configuration guide.
Dashboard URL Parameters
Append query parameters to a dashboard URL to control its initial state:
| Parameter | Values | Effect |
|---|---|---|
standalone | 0 (default), 1, 2, 3 | Hides navigation bar and/or title |
show_filters | 0, 1 | Shows or hides the filter bar |
expand_filters | 0, 1 | Collapses or expands the filter bar |
Example:
https://calabi.yourdomain.com/bianalyst/dashboard/42?standalone=1&show_filters=0
This renders the dashboard without the navigation bar and hides the filter bar — ideal for embedding in kiosks or TV displays.