Dashboards
Pin charts and notes onto a free-form grid your whole team sees: add widgets, arrange them, edit charts in place and keep numbers fresh.
A dashboard is one page with the numbers that matter: charts from your saved queries, and text notes, on a grid you arrange. Everyone in your organization sees the same dashboards, and you can share one publicly with a link.
Build a dashboard
Create it
Go to Dashboards then New dashboard. Click the title to name it, and add a description if it helps people know what they’re looking at.
Add widgets
Click Widgets. Pick Text for a heading or a note, or any saved query that has a chart. The widget lands at the bottom of the grid.
Arrange them
Hover over a widget and drag its handle to move it. Drag the bottom-right corner to resize it. Other widgets shift out of the way. The grid is four columns wide.
Changes save as you go. Faster still: ask the agent to “build a dashboard with weekly revenue, new customers and churn”, or pin charts from a notebook with Add to dashboard.
Working with widgets
Chart widgets
- The title is the query’s name unless you click it and type your own. A dashboard title doesn’t rename the query.
- The info icon appears when the query has a description, and shows it.
- Chart settings (the sliders icon, or the widget’s ⋯ menu) edits the chart right on the dashboard.
- Open query goes to the query behind the chart.
- Remove from dashboard takes the widget off this dashboard. The query and its chart stay, and so does the chart on any other dashboard.
A chart belongs to its query
Chart settings are saved on the query, so changing a chart on one dashboard changes it everywhere that query’s chart appears. For a different view of the same data, save the SQL as a second query.
Text widgets
Type straight into a text widget; it saves as you type. If a save fails, your draft is kept in the browser and offered back the next time you open the dashboard. On a shared dashboard’s public page, text is formatted as Markdown: # Headings, lists, **bold**, *italic* and links.
Keeping numbers fresh
A dashboard shows each query’s latest saved result, so it opens instantly and never slows down your database. That result is from the last time the query ran: when someone ran it, when the agent saved it, or when Run all queries was last used.
To bring every chart up to date, open the ⋯ menu at the top of the dashboard and click Run all queries. Progress shows as each one runs.
No scheduled refresh yet
Dashboards don’t refresh on a schedule yet. For a Monday review, click Run all queries first. A chart that says No result cached yet needs its query run once.
More
- Share makes a public, read-only link. See Share a dashboard.
- Delete dashboard, in the ⋯ menu, removes the dashboard only. Its queries and charts stay.
- If the same dashboard is open in two tabs and one changes it, the other refreshes to the latest layout rather than overwriting it.
- Big dashboards stay fast: each chart draws when you scroll near it, and very large results are sampled (see Big results).
A founder’s first dashboard
Six charts cover a weekly review for most online businesses:
- Revenue this month, as a Number with the change from last month
- Revenue by week, as a Line
- New customers by week, as a Column chart
- Active customers, as a Number
- Churn rate by month, as a Line
- Revenue by plan or product, as a Bar chart
Build them on certified metrics and they’ll agree with whatever the agent tells you.
Something unclear or missing? Troubleshooting covers the common errors, or message us.