Dashboards
A dashboard is a top-level container that
- provides a Grid system for Widgets
- provides a unique URL Path for access e.g.
/workspace-name/dashboard-name - sets global style preferences for grid and widgets
Key Features
- Flexible Grid Layout - Customizable columns and rows with automatic responsive behavior
- Custom URL Paths - User-friendly, shareable URLs for each dashboard
- Style Presets - Optimized rendering for low-frequency and high-frequency data updates
- Widget Management - Add, position, and configure multiple widgets on a single dashboard
- Sharing Controls - Manage access permissions for users and teams
- Real-Time Updates - Widgets automatically update as new data arrives
Grid System
The grid automatically
- controls how widgets can be placed on a dashboard
- controls how widgets behave under certain dynamic conditions
- handles responsive sizing on different screen sizes, resizing a window, rotating a device
- handles widget overflow and scrolling
- handles empty cells
The grid is defined by
- Columns - Number of columns
- Rows - Number of rows
The grid size results from the numbers of columns and rows, and determines the maximum number of widgets can be placed on a dashboard.
Widgets positioning
- Cell Index - Starting position in the grid
- Column Span - How many columns the widget occupies
- Row Span - How many rows the widget occupies
Style Presets
Styles are optimized to enhance dashboard user-experience based on your data update patterns. For dashboards with high-frequency data updates (shorter than a minute), specialized styles ensure stable positioning of tooltips, numbers, and chart labels, while maintaining smooth rendering performance.
Currently Dashgrid provides two style presets:
- Default LF: for dashboards updated in low-frequency (update cycles longer than a minute)
- Default HF: for dashboards updated in high-frequency (update cycles shorter than a minute)
URL Path
Each dashboard has a unique URL Path within its workspace. The canonical address combines the workspace path and dashboard path.
e.g. https://dashgrid.com/workspace-path/dashboard-path
When creating a dashboard, its title automatically provides a readable path. In title mode, the Full URL preview always follows the title; no separate slug input is shown. Admins and Owners can instead enable a server-generated random path in Dashboard Settings. Editors cannot make a title change that would change a title-derived path.
Title-derived paths use 3–50 lowercase letters, numbers, and hyphens. The form checks availability within the workspace. Changing the path immediately changes the dashboard and widget addresses; existing links using the previous path stop working and do not redirect.
Access Control
Data Buckets and API Keys
Data Buckets and API Keys
- can be only accessed and managed by users with roles Owner or Admin
- are only accessible within the dashboard where those are defined
For more see the Sharing section.
Deleting a Dashboard
Deleting a dashboard permanently deletes everything it contains:
- all Widgets
- all Data Buckets, including all stored records
- all API Keys — they are revoked immediately, and clients using them stop working
- all sharings and pending invites — every user loses access to the dashboard immediately
Deletion is restricted to the dashboard Owner and must be confirmed by typing the dashboard title. It cannot be undone.
Deletion is all-or-nothing: if the dashboard's buckets and keys cannot be removed from the data service, nothing is deleted and you can retry.
Before deleting, stop all clients that still submit data to the dashboard's buckets.