Dashboard creation and editing is available to admin users. Non-admin users can view dashboards but cannot create or modify them.
Creating a New Dashboard
- Navigate to the Reports page from the main sidebar.
- Click Create New to open the dashboard editor.
- Enter a name for your dashboard in the toolbar at the top.
- Add widgets, configure filters, and arrange the layout.
- Click Save when finished.
The Dashboard Editor
The dashboard editor has three main areas:- Toolbar — Dashboard name, Add Widget button, Edit Filters button, Settings, and Save/Cancel controls. An unsaved changes indicator appears when you have pending edits.
- Widget Grid — A 12-column grid where your widgets are arranged. Drag widgets to reposition them and resize by dragging their edges.
- Widget Editor — Opens as a full-page view when you add or edit a widget.
Adding Widgets
Click Add Widget in the toolbar to open the widget editor. The editor has two panels:- Left panel — Widget type selector, title, widget-specific configuration, and optional hyperlink/layout settings.
- Right panel — Live preview at the top and data source configuration below.
Widget Types
Select a widget type from the left panel. Each type has its own configuration options:Metric Card
Metric Card
Displays a single aggregated number as a KPI with optional trend and sparkline.
| Setting | Description |
|---|---|
| Aggregation | COUNT, SUM, AVG, MIN, MAX, or COUNT DISTINCT |
| Column | The numeric column to aggregate |
| Format | Number, currency, percent, or compact notation (K, M, B) |
| Currency symbol | Symbol to display for currency format |
| Decimal places | Number of decimal digits to show |
| Trend | Optional comparison to a prior period |
Bar Chart
Bar Chart
Vertical or horizontal bars for comparing values across categories.
| Setting | Description |
|---|---|
| X-axis | Category column (auto-detect available) |
| Y-axis | One or more aggregated measures |
| Orientation | Vertical or horizontal |
| Stacked | Stack multiple series into a single bar |
| Data labels | Show values on bars |
| Legend | Show/hide legend |
| Reference lines | Add horizontal threshold or goal lines |
| Value format | Currency, percentage, or compact notation |
| Date truncation | For date columns: year, quarter, month, week, or day |
Line Chart
Line Chart
Trend lines over a time dimension or ordered category.
| Setting | Description |
|---|---|
| X-axis | Time or category column |
| Y-axis | One or more aggregated measures |
| Smooth | Curved lines instead of straight segments |
| Data points | Show point markers on the line |
| Data labels | Show values at each point |
| Legend | Show/hide legend |
| Reference lines | Add threshold or goal lines |
| Date formatting | Control how dates appear on the axis |
Area Chart
Area Chart
Filled area visualization, useful for showing volume over time.
| Setting | Description |
|---|---|
| X-axis | Time or category column |
| Y-axis | One or more aggregated measures |
| Stacked | Stack areas (normal or 100%) |
| Smooth | Curved fill instead of straight |
| Opacity | Control fill transparency |
| Legend | Show/hide legend |
Pie / Donut Chart
Pie / Donut Chart
Proportional breakdown of a category.
| Setting | Description |
|---|---|
| Dimension | Category column to slice by |
| Measure | Aggregation for slice size |
| Variant | Pie or donut (hollow center) |
| Labels | Inside or outside the slices |
| Percentages | Show percentage on each slice |
| Legend | Show/hide legend |
| Sort | Ascending, descending, or none |
Scatter Chart
Scatter Chart
Plot data points by two axes with optional bubble sizing.
| Setting | Description |
|---|---|
| X-axis | Numeric column for horizontal position |
| Y-axis | Numeric column for vertical position |
| Size column | Optional — maps a third value to point size (bubble mode) |
| Color column | Optional — color points by category |
| Labels | Show labels on points |
| Trendline | Add a trendline overlay |
Data Table
Data Table
Sortable, paginated table of raw or aggregated data.
| Setting | Description |
|---|---|
| Columns | Select which columns to display |
| Page size | Rows per page: 5, 10, 25, 50, or 100 |
| Sortable | Allow column header sorting |
| Pivot | Pivot a column’s values into separate columns |
| Date formatting | Control how date columns are displayed |
Text
Text
Static text block for titles, annotations, or section labels.
| Setting | Description |
|---|---|
| Content | Text or Markdown content |
| Markdown | Enable Markdown rendering (bold, italic, code blocks) |
| Alignment | Left, Center, or Right |
| Font size | Small, Normal, Large, or XLarge |
Configuring Data Sources
Below the live preview, you configure where the widget gets its data. There are three modes:Guided Mode
The default mode. It provides a simplified interface tailored to the widget type:- Select a table — Pick from the available data sources (Accounts, Opportunities, Activities, etc.).
- Choose columns — Select the columns to display or aggregate.
- Set aggregations — For charts and metrics, choose how values are combined (SUM, AVG, COUNT, etc.).
- Add filters — Narrow the data for this specific widget.
- Configure grouping — For charts, choose the group-by column (the X-axis dimension).
Advanced Mode
A full visual query builder for complex queries:- Schema explorer — Browse all available tables and columns in a sidebar.
- Table selection — Add one or more tables with join conditions (LEFT, RIGHT, INNER, FULL).
- Column selection — Pick columns with optional aggregations and aliases.
- Filter builder — Create filter conditions with 15 operators (equals, greater than, in list, like, between, is null, etc.).
- Sort builder — Define sort order on one or more columns.
- Calculated fields — Define computed columns using expressions.
- SQL preview — See the generated SQL for your query.
- Results preview — Execute and preview results directly in the builder.
Saved Query Mode
Select from previously saved queries to reuse a data configuration across multiple widgets.Aggregations
When building charts or metric cards, you aggregate raw data into summary values. The available aggregation functions are:| Function | Description | Use For |
|---|---|---|
| COUNT | Number of rows | ”How many accounts?” |
| COUNT DISTINCT | Number of unique values | ”How many unique owners?” |
| SUM | Total of all values | ”Total ARR across accounts” |
| AVG | Mean of all values | ”Average deal size” |
| MIN | Smallest value | ”Lowest health score” |
| MAX | Largest value | ”Highest renewal amount” |
Filtering Widget Data
Each widget can have its own filters that are independent of the dashboard-level filters. Widget filters narrow the data before aggregation. To add a widget filter in guided mode:- Click Add Filter in the data configuration section.
- Select the column to filter on.
- Choose an operator (equals, greater than, in list, contains, etc.).
- Enter the filter value(s).
Widget-level filters are fixed into the widget’s query and are not visible to viewers. Dashboard-level filters (configured separately) appear in the filter bar and let viewers adjust them interactively. See Using Filters for details on dashboard filters.
Dashboard-Level Filters
Dashboard filters appear in the filter bar and let anyone viewing the dashboard narrow data across all widgets at once. To configure them:- Click Edit Filters in the dashboard editor toolbar.
- Add a filter and configure:
- Label — The name shown in the filter bar.
- Type — Multi-select, single select, text, date range, or number range.
- Column — The data column this filter targets.
- Table — Which data source the column belongs to (optional if unambiguous).
- Default value — The initial filter state when the dashboard loads.
- Dynamic options — When enabled, filter dropdown values are loaded from your data automatically.
Arranging the Layout
The dashboard grid is a 12-column layout. When you add a widget, it is placed at the next available position with a default size based on its type:| Widget Type | Default Size (columns x rows) |
|---|---|
| Metric Card | 3 x 2 |
| Bar Chart | 6 x 4 |
| Line Chart | 6 x 4 |
| Area Chart | 6 x 4 |
| Pie / Donut | 4 x 4 |
| Scatter Chart | 6 x 4 |
| Data Table | 12 x 4 |
| Text | 4 x 2 |
Repositioning Widgets
Drag any widget by its header to move it to a new position on the grid. Other widgets reflow automatically to accommodate the change.Resizing Widgets
Drag the bottom-right corner of a widget to resize it. Widgets have a minimum size of 2 x 2 grid units to ensure readability.Responsive Behavior
The grid adapts to different screen sizes:| Screen Width | Grid Columns |
|---|---|
| 1200px+ | 12 |
| 996px+ | 10 |
| 768px+ | 6 |
| 480px+ | 4 |
| Below 480px | 2 |
Editing an Existing Dashboard
To modify a dashboard you’ve already created:- Navigate to the Reports page.
- Click the three-dot menu on the dashboard card.
- Select Edit to open the dashboard editor with the existing layout.
- Make your changes — add, remove, or reconfigure widgets, adjust filters, or rearrange the layout.
- Click Save to persist your changes.
Duplicating a Dashboard
To create a copy of an existing dashboard:- Navigate to the Reports page.
- Click the three-dot menu on the dashboard card.
- Select Duplicate.
Deleting a Dashboard
- Navigate to the Reports page.
- Click the three-dot menu on the dashboard card.
- Select Delete.
- Confirm the deletion.
Optional Widget Settings
Hyperlinks
You can attach a hyperlink to any widget. When configured, a link icon appears in the widget header that navigates to the specified URL. This is useful for linking to related views, external tools, or filtered account lists.- URL — The destination link.
- Link title — Tooltip text shown on hover.
- Target — Open in a new tab or the current tab.
Layout Constraints
You can set minimum and maximum width/height for a widget to prevent it from being resized beyond useful bounds.Related Pages
- Reports Overview — Key concepts, widget types, and data sources
- Viewing Dashboards — Navigate dashboards and interact with widgets
- Using Filters — Filter bar, filter types, and cross-filtering
- Managing Pinned Dashboards — Pin, unpin, and reorder dashboards