Dashboards
Dashboards put your saved charts, section headings, notes and images on a grid you arrange yourself, with one set of controls for every chart, folders in the sidebar, and public links for people outside your team.
A dashboard is a page of panels on a 24-column grid: charts from your saved queries, section headings, markdown notes and images. One bar of controls above the panels sets the time range, granularity, filters, breakdowns and chart type for every chart at once. You arrange the panels in edit mode, keep dashboards organized in folders in the sidebar, and share any dashboard through a public link.
To build the charts themselves, see the Query Builder: Insights, Funnels, User Journeys, Retention, Heatmaps and Formulas.
Creating a dashboard
Open Dashboards from the project sidebar, then click + next to the Dashboards heading and choose New board. You can also right-click any empty space in the dashboards list. Give it a name and, optionally, a description, an icon and a color.
A new dashboard is empty. Click Add query to build its first chart, or Edit layout to add headings, notes and images.
New projects start with a few dashboards made for the SDK you connect, such as Engagement, Retention and Monetization for Roblox. They're ordinary dashboards: edit, rename or delete them like your own.
Viewing a dashboard
The header shows the dashboard's icon, name and description. Next to them are Pin, Share and Edit, and the ⋮ menu with Duplicate, Rename / style, Share and Delete.
Controls for every chart
The bar above the panels applies to every chart on the dashboard:
| Control | What it does |
|---|---|
| Time range | The period every chart covers, with the same presets as the query builder, and the timezone beside it. Default clears it, so each chart goes back to the range it was saved with. |
| Granularity | How time charts group their points: by minute, hour, day, week and so on. Retention charts use the nearest of day, week or month. |
| Filter | Add filter adds a condition to every chart, on top of each chart's own filters. Use it for questions like "only mobile players" across the whole dashboard. |
| Breakdown | Add breakdown splits every chart by a property. A chart that already breaks down by the same property keeps its own, and World Map charts ignore it. |
| Chart type | Switches every insight chart to the same display: line, column, table, metric and the rest. Default puts each chart back to its own. Funnels, journeys, retention and heatmaps keep their own display. |
| Refresh | Click to re-run every chart now. Open the arrow beside it to choose how often the dashboard refreshes on its own: every 30 seconds (the default), minute, 5 minutes, 15 minutes or hour, or Off. The button shows the interval while it's on. |
These controls change what you see, not the dashboard: nobody else's view changes, and they're remembered for this dashboard in this browser. The refresh interval is kept in the page's URL, so a link you send opens with the same interval.
A chart you've zoomed into (by dragging across it) keeps its zoomed range until you reset the zoom.
How refreshing works
Results are cached, so opening a dashboard doesn't re-run every query. The auto-refresh interval says how old a result can be before it's recomputed: at 30 seconds, a result less than 30 seconds old is shown as it is, and an older one is run again. Clicking Refresh always re-runs every chart.
A chart's header
Each chart's header shows its name, its description, and how fresh its data is:
| Label | Meaning |
|---|---|
| 2m ago | When the result was computed. Click it to refresh just this chart. |
| Fetching | Checking for an up-to-date result. Usually answered from the cache in a moment. |
| Queued | Waiting behind other queries. It starts shortly. |
| Computing | The query is running. The chart updates when it finishes. |
| Timed out | The query took too long. Try a shorter time range, then click to retry. |
| Failed | The last run failed. Click to retry. |
| Not available | The chart uses a feature that isn't enabled for your organization. Retrying won't change it. |
Hover the ⓘ beside the name to see the full description, the query type, its time range, who created it and when, and who edited it last.
A chart's menu
The ⋮ on a chart has:
- Edit (or View, if you can't edit dashboards): open the query in the query builder.
- Duplicate: save a copy of the query under a new name, on this dashboard or another one.
- Maximize: show the chart full screen.
- Export to: download the chart's data as CSV. Line, Stacked Line, Column, Stacked Column, Pie and Retention Curve charts can also be saved as an SVG, PNG or JPEG image. Funnels, user journeys, heatmaps and World Map charts have no Export to.
- Delete: delete the saved query. It's removed from every dashboard it's on, and can't be undone. To take a chart off just this dashboard, use Remove in edit mode instead.
Editing a dashboard
Click Edit to enter edit mode. Faint cells show the grid. Nothing you change is saved until you click Save, and Discard throws every change away. If you leave to edit a query, your unsaved layout is kept and you come back to it.
In edit mode you can:
- Move a panel by dragging its header (or anywhere on a section heading). A dashed outline shows where it will land. Drop it on another panel to swap the two; drop it on empty space to place it there. Other panels move up to fill gaps.
- Resize a panel by dragging its bottom-right corner. Each panel type has a minimum size.
- Select a panel by clicking it. Each panel has Edit, Duplicate (headings, notes and images) and Remove buttons. Removing a chart only takes it off the dashboard: the saved query is kept.
- Rename the dashboard, or change its description, icon or color by clicking them in the header.
- Reset panel sizes: the ↺ button next to Add panel puts every panel back at its default size, in its current order. It asks first, and Discard undoes it.
The layout is the same on every screen wide enough to show it. On a phone, panels stack in reading order instead, and can't be moved or resized.
If someone else saves the same dashboard while you're editing it, Save won't overwrite their changes. You'll be asked to reload the dashboard (and lose your edits) or keep editing.
Panels
Add panel places a new panel at the top of the dashboard and moves everything else down.
| Panel | What it shows | How you edit it |
|---|---|---|
| Query | A chart from a saved query: an insight, funnel, user journey, retention or heatmap | Add panel → Query opens the query builder. Save the query and it's added to the top of the dashboard. |
| Section heading | One line of plain text, full width, without a card. Use it to split a long dashboard into sections | Double-click it, type, and press Enter. Escape cancels. |
| Markdown note | A card of formatted text: headings, lists, links, tables, bold and italic | Double-click it to write in the panel. Enter saves, Shift+Enter starts a new line, Escape cancels. |
| Image | An uploaded picture, cropped to fill the panel or fitted inside it | Add panel → Image to upload. Use Edit to replace it, add a description (alt text), or switch between cover and contain. |
Images can be PNG, JPEG, WebP or GIF, up to 10 MB. Notes can include images too: while writing a note, click Image to upload one into the text. Raw HTML and images from other websites aren't shown in notes.
A dashboard can hold up to 200 panels. A chart can't be duplicated in place, because a saved query appears on a dashboard once: use Duplicate in the chart's ⋮ menu to make a copy of the query.
Organizing the sidebar
The dashboards list in the sidebar holds your dashboards and folders.
- Folders: create one with + → New folder, or New subfolder from a folder's ⋯ menu. Folders can be nested up to 6 levels deep. A folder's ⋯ menu can also create a dashboard inside it (New board here), rename or restyle it, and delete it. Deleting a folder moves its dashboards and subfolders up a level; no dashboard is deleted.
- Pins: click Pin in a dashboard's header to add it to the Pinned section at the top of your sidebar. Pins are personal.
- Search: type in the search box to filter dashboards by name. Folders with a match stay visible.
- Right-click a dashboard or folder to open its menu. Right-click empty space for New board and New folder.
Rename / style and Duplicate open a small editor beside the dashboard or folder. Duplicate copies the dashboard and its queries, so the copy can be changed without affecting the original. It keeps the original's icon, color and description.
Sort order
The button at the bottom of the sidebar chooses how the list is ordered:
| Sort | Order |
|---|---|
| Custom (shared) | The order everyone on the project sees. Drag to change it. This is the default. |
| Custom (mine) | Your own order, which only you see. Drag to change it; Reset my order clears it. |
| Recent | Folders first (alphabetically), then the most recently created dashboards. |
| Name | Folders first, then dashboards, each alphabetically. |
You can drag a dashboard or folder into another folder, or out to the top level, in any sort. Dragging to reorder only works in the two Custom sorts. In Recent and Name, the folder you're dropping into is highlighted, and the dashboard takes its place in that folder's sort.
Sharing a dashboard
Click Share in the dashboard's header, then Generate Public Link. Anyone with the link can view the dashboard without signing in, and the charts stay live as your data updates. Click the link to copy it.
- Time Range Enabled lets viewers change the time range and granularity. Breakdowns Enabled lets them add filters and breakdowns from the Property and User tabs of the filter picker. Everything else about each chart stays as you saved it.
- PIN: protect the link with a 4 to 10 digit PIN, either when you create it or later. Viewers are asked for it before the dashboard is shown.
- Revoke Link stops the link working.
Shared dashboards are read-only: viewers can't edit panels or queries, refresh a chart on demand, or add annotations.
Sharing a single chart
To share one chart instead of a whole dashboard, open it in the query builder and click Share in its header. The link (share.gamebeast.gg/q/…) has the same options, PIN and Revoke Link, and shows a preview of the chart when you paste it into Slack or Discord.
Sharing a single chart is being rolled out. If there's no Share button in the query builder, it isn't enabled for your organization yet.
Permissions
| Action | Needs permission to |
|---|---|
| View dashboards, pin them, and set your own sort order | View boards |
| Create a dashboard | Create boards |
| Edit a dashboard, its panels, folders and the shared order | Update boards |
| Delete a dashboard, a folder, or a chart | Delete boards |
| Create a public link | Create shareables |
Building or editing a chart also needs permission to create or edit queries.
With the assistant and MCP
The assistant and agents connected over MCP can build dashboards for you. They can save charts to dashboards, lay out panels, add section headings and notes, and organize dashboards into folders. In the dashboard, each change needs your approval. They can't upload images, pin dashboards, or change anyone's private sort order.
Engagement Markers
Markers are used to track player interactions and events in your experience. This data can be used to create heatmaps and other visualizations to help you understand how players are interacting with your experience.
Query Builder
Turn the markers your experience sends into charts: pick a query type, choose what to measure, filter and break it down, set the time range and chart, then save it to a dashboard or share it.