Skip to main content
The Custom Dashboards page lets you build project-shared dashboards from governed queries and visualizations. You create a dashboard, query your data with SQL or the visual query builder on the platform tables, and save each visualization as a widget. Every dashboard is shared across the project. There are no fixed metrics on this page. Each widget shows whatever its query returns, over the project’s analytics data: events, sessions, LLM calls, feedback, pipeline results, and custom tags. Queries are checked before you save them, and they only see this project’s data. To start from a question, write a query in Analytics Explorer → Query and select Add to dashboard. Navigation: Insights → Custom Dashboards Date range: Set at the top of the dashboard: 24 hours, 7 days, 30 days, or 90 days. Widgets that use the from and to date tokens follow this range, and all applicable widgets update. Filters: Select All environments and All channels at the top of the page to narrow the data by deployment environment and channel. Filter selections are reflected in the page URL, so you can bookmark a filtered view or share it with a colleague. When a project has no dashboards, the page shows No dashboards yet. Select New dashboard to create your first one. Custom Dashboards

Dashboard actions

The dashboard picker switches between the project’s dashboards. The header shows how many dashboards exist and who created the current one.
Widget titles are typed by whoever builds them. Open the widget’s query before you trust its title. If a query returns a field with no values, its table or chart shows an empty column.

Build a widget

Each visualization on a dashboard is a widget. Select Add widget to open the widget editor, which opens as Untitled widget and stays open until you save or cancel. To build a widget:
  1. Open a dashboard and select Add widget.
  2. On Query data, select a table from the table selector, for example abl_platform.platform_events.
  3. Write your SQL. Use the Schema panel to find column names and types.
  4. Select Run query. The result panel below the editor reports the rows returned.
  5. Open Preview rows to confirm the query returns what you expect.
  6. Open Visualize, choose a chart type, then map your fields to the axes.
  7. Select Save widget.

Query data

The SQL editor sits at the center of the tab, with the table selector, Schema for AI, and Run query above it. Schema for AI copies the selected table’s schema in a form an AI assistant can use to draft the query. Queries are scoped by tenant_id and project_id by default. Use the from and to date tokens when the widget should follow the dashboard date range. See Example of Query scoping. Widget editor with a SQL query and the Schema panel The right rail supports the editor with two panels. Custom tags live in the custom_dimensions column, a map of string keys. Read one in SQL as custom_dimensions['key'].

Label dimensions in a visual query

For tables that support the visual query builder, such as output item tables, give each grouped dimension a readable label so dashboard users don’t see raw field names. For example, label the dimension dim_pnr as Booking reference.

Result panel

After you run a query, the panel below the editor holds the result. Switch between Preview rows and Visualization without leaving the result, so you can check the data and the chart against each other. The result reports five statistics. Below the statistics, a chip for each column shows the data role the platform assigned it, for example timestamp: time and rows: metric. These roles determine which columns are available to each axis in Visualize. Preview rows displays the result as a table, one column per field in the result set. Columns from a visual query show their dimension labels. Result panel with statistics, data role chips, and preview rows

Visualize

Visualize builds the chart from the result set. A status badge reads Ready when the current mapping produces a valid chart. Four tabs configure the visualization. Visualization with the Charts tab and a line chart marked Ready

Widget API details

Each widget’s data is also available through the widget data API, so you can pull the same numbers into your own reports or scripts. The API details dialog shows the exact request the dashboard runs for the widget, with the dashboard’s current date range and active filters already applied. Use the Filters table to check why a widget shows different numbers from the rest of the dashboard. A filter that doesn’t apply to the widget’s table appears in the list but doesn’t change the result.

Multi-select filters

A dashboard filter can accept one value or several. When you switch a filter to multi-select, the platform updates the SQL of every widget that uses the filter’s token, so the widget matches any of the selected values. If a single-value token receives more than one value, the widget stops filtering on that field rather than silently using only the first value. Switch the filter to multi-select to filter on several values.

Example of query scoping

The platform scopes queries to the current tenant and project by default. Let us consider abl_platform.platform_events as the query table. Use the date tokens when a widget should follow the dashboard date range. The following query counts events over time and follows the dashboard date range: