Dashboards
A dashboard holds charts, filters and Insights blocks built from one data model’s fields, with an optional chat assistant. Every chart answers from the model’s published definitions.
Reading a dashboard
Section titled “Reading a dashboard”- Hover a chart to see its exact values. Hover a shortened label, such as a long axis label, a legend name or a table cell, to read it in full.
- Filters sit on the dashboard. Change one and the charts it applies to update. The page address keeps your choices, so you can copy it and share that filtered view with someone who has access.
- Freshness: results are kept for a while so dashboards open fast. The header shows when they were computed (“Updated … ago”). Click Refresh data to ask the warehouse again.
- The chat assistant answers questions about the dashboard in plain words. See Chat assistant.
- Insights blocks explain findings in the data. They use their own conditions and period, so changing a dashboard filter does not change their text. See Insights blocks.
- Download a PDF, an image or an Excel file of what you’re looking at. See Downloading a dashboard.
- Pin a dashboard with the star next to its title to keep it in your sidebar.
- If you can edit it, Edit is at the top right.
Creating a dashboard
Section titled “Creating a dashboard”- Go to Dashboards (or a folder page) and click New dashboard.
- Give it a Name, pick the Data model its charts use, and optionally add a description.
- The builder opens. Add charts from the model’s fields, no SQL needed.
A new dashboard starts in your Personal folder, private to you until you move it into a shared folder. Created from a folder page, it starts in that folder instead.
Dashboard names are unique across the workspace. You need at least one published data model first. Models that have never been published are dimmed in the picker, marked Not published yet.
The dashboard builder
Section titled “The dashboard builder”Click Edit to open the builder, and Done to go back to the view everyone else sees. The builder needs a tablet or desktop-sized screen.
| Area | What it does |
|---|---|
| Fields (left) | The model’s measures and dimensions. Click one to add it to the selected chart, or drag it where you want it. Fields that can’t combine with the selected chart are greyed out, and say why. |
| Insert bar (top) | Add charts, filters and Insights blocks; switch the Chat assistant on or off; Tidy layout; undo and redo. |
| Canvas (middle) | Move tiles by their header and resize them from their edges. Click a tile to select it. |
| Inspector (right) | With nothing selected: the dashboard’s Details (name, description, data model) and Theme. With a chart selected: its Data and Style. |
To let go of a selected chart and see the dashboard’s details and theme again, press Esc. If you’re typing in a field, click outside it first.
Hide the fields panel or the right panel with the buttons in the header to give the canvas more room.
Where a chart’s numbers come from
Section titled “Where a chart’s numbers come from”Select a chart. Under its wells, Where the numbers come from lists each field it uses, with what the field is (“Sum of amount · Orders”, or its formula). Click one for more, without leaving the builder: what the field is built from, and which other charts use it, on this dashboard first and then on others you can see. Click a chart on this dashboard to select it. Open in model opens the field in the model builder (if you can edit models). A filter shows the same thing for the field it filters by.
In the fields panel, hover a field and click ⋯ to see the same thing before you use it.
These read the model version the dashboard reads: always the published one, never the draft.
Fixing a chart whose field is gone
Section titled “Fixing a chart whose field is gone”When a model change removes or renames a field, the charts and filters using it say “… is no longer in the model”. If you can edit the dashboard, its header shows 2 need attention. Click it for the list, then click one to go to it (from the view, this opens the builder on it). People who only view the dashboard don’t see this.
In the builder, the missing field’s dashed red pill in the wells explains what happened. Pick a field in Replace with… to put it in the missing one’s place, or click Remove from this chart. A broken chart also offers Replace with… on the chart itself.
Charts
Section titled “Charts”Each chart type has wells: slots that take a measure or a dimension. Drop fields into them on the Data tab, or click a field in the fields panel to have it placed for you.
| Chart | Good for | Wells |
|---|---|---|
| Bar | Comparing values across categories | Category, Values, optional Split by. Columns or horizontal bars; Auto (the default) turns a ranking or a chart with long names into horizontal bars so every name reads in full. |
| Line | A trend over days, months, quarters or years | Time axis, Values, optional Split by |
| Area | A trend, and how each part contributes to it | Time axis, Values, optional Split by |
| KPI | One headline number, with its change or a target | Value, optional Target, optional Trend over (a date, for a sparkline) |
| Donut | How a whole splits by category or status | Slices, Value |
| Combo | A value as bars and a rate as a line, e.g. revenue and margin | Category, Bars (up to 3), Lines (up to 3) |
| Table | Detailed values to sort and highlight | Columns |
Charts show up to six series, each in its own colour. Every chart with two or more series has a legend. Hover a bar or a slice (or its legend entry) and the rest step back; a donut shows that slice in its centre. A Top N chart groups the rest as a grey Other. Axes use round numbers, and values read as 1.2M or 527.9K. Hover a tile to duplicate or delete it.
KPI comparisons
Section titled “KPI comparisons”A KPI can compare against the previous period, the same period last year or its target. Turn off An increase is good for numbers where down is good, like costs, churn or delays. The number can be coloured by its change or by thresholds you set.
Styling a chart
Section titled “Styling a chart”The Style tab shows only the sections that apply to the chart type:
| Section | Options |
|---|---|
| Header | Show or hide the title; a subtitle (e.g. the period it covers) |
| Numbers | How values are formatted |
| Colors | A colour per series; for one measure, one colour, a colour per category, shaded by value, or coloured by rule. Colours always come from the dashboard theme’s palette. |
| Legend and labels | Legend position (auto, top, bottom, right, hidden); value labels on every point, the latest, or the high and low |
| Axes | Axis labels, gridlines, axis titles, fixed axis start and end |
| Reference lines | A target or average line, with its own label. A long label is shortened to fit the chart and sits above the line. |
| Order and limit | Order (the field’s own order, A to Z, largest first, smallest first); show only the top N and group the rest as “Other” |
| Series | Side by side, stacked, or 100% |
| Scale | Put lines on their own right-hand scale (bar, line, area and combo) |
| Line | Smooth, straight or step; point markers |
| Dates | Date labels as Jan 26, January 2026 or 2026-01 |
| Rows (table) | Comfortable or compact rows, a totals row, a row limit |
| Conditional formatting (table) | Data bars (a loss reaches left from a zero line), a heatmap, and rules that highlight values |
Filters
Section titled “Filters”Add a filter from the insert bar, then drop the field it filters into its well. The value you set in the builder is what viewers start with; each viewer can then change it for themselves.
| Filter | What it does |
|---|---|
| Pick values | Choose regions, statuses, products… as a dropdown, a list or buttons. Optionally allow several values, or exclude the picked ones. |
| Text search | Match part of a name (“contains”). |
| Date range | Last 30 days, this quarter, year to date, or custom. |
| Single date | On, before or after one date. |
| Number range | Between two values, on a slider. |
| Number comparison | At least, at most, or exactly a value. |
| Time grain | Regroup time charts by day, week, month… |
| Top N | Show only the top 5, 10 or 20. It has a minimum width, a little wider than other filters, so its choices stay readable. |
Choices in a filter’s list come live from your data, so new values appear without editing the dashboard.
Chat assistant
Section titled “Chat assistant”The chat assistant is a chat button at the bottom corner of the dashboard. Readers click it to open a floating chat and ask questions in plain words. It reads the dashboard with the filters the reader has set. It never changes anything.
- Turning it on: in the builder, switch on Chat assistant on the insert bar. Switch it off the same way. It floats over the dashboard, so it takes no place on the grid, and a dashboard has one.
- Setting it up (inspector): its name (“Assistant” by default), introduction, suggested questions, which charts it talks about, focus notes, button colour, and whether to show its working. The button uses the dashboard’s accent or a chart colour. With working shown, readers see which charts and data each answer read.
- Reading: click the button to open the chat and the cross to close it. Closing keeps the conversation.
Chats with the assistant are saved on the dashboard. Everyone who can open the dashboard sees them. Share-link viewers are the exception: their chats are private to them.
The chat assistant needs your workspace to have AI turned on, and uses its monthly AI credits. Its credits show under Dashboard chat assistants in Usage. What it can see of your data follows the rules in AI and your data.
Insights blocks
Section titled “Insights blocks”An Insights block is a written summary on the dashboard’s grid: who leads, who lags, what changed, and where to look next. It reads the data model directly, independently of the charts. Riff BI finds the facts in the data, and AI puts them into words; the figures in the text stay tied to those facts.
Adding and setting up a block
Section titled “Adding and setting up a block”- In the dashboard builder, click Insights on the insert bar. Select the new block to open its inspector.
- Under What it’s about, choose a Subject, such as Salesperson or Region. Each value of that field is something the summary can compare.
- Add one to six Measures. The first starts as the Headline, which decides who leads. Others can support the headline or provide context. For each, choose Higher is better, Lower is better or Neither, so lower costs or shorter delays are understood correctly.
- Under Which rows count, add any fixed conditions. Optionally choose a date field, period and comparison: the previous period or the same period last year.
- Choose What to look for: leaders and laggards, trade-offs, gaps to the group, change against the comparison period, or concentration. Cover sets how many subjects the text discusses.
- Under How it’s written, choose the audience and length, whether to suggest a next step, and any focus notes. Click Write insights on the block.
The block always uses the conditions and period in its own settings. Dashboard filters do not change it. Read the scope beside the text before comparing it with a filtered chart. For an answer that follows your current dashboard filters, use the chat assistant.
Reading and updating insights
Section titled “Reading and updating insights”- Check the figures: hover or focus a bound name or figure to see the fact behind it. The block also shows when it was written and which rows it covers. In the builder, the facts list lets you inspect the findings.
- After changing settings: the old text stays visible with The settings changed since this was written. Click Update to use the new settings. Editing a setting alone does not write new text.
- Write again: editors can ask for a fresh wording. Viewers read the saved block automatically; existing text is reused when its settings and data match.
- Formatting: change text size, alignment, emphasis on names and figures, list style, spacing, text width and heading. These change the appearance straight away and do not use an AI call. Colours and fonts follow the dashboard’s theme.
- Not enough data to compare: the query needs at least two subjects. Check the subject, measures, conditions and date period. Warnings under the text explain any rows left out.
- Credits: writing uses the workspace’s AI credits. If AI is switched off or credits are exhausted, the block can still show earlier saved text; without earlier text it shows why insights are unavailable.
Themes
Section titled “Themes”With nothing selected, open the inspector’s Theme tab to style the whole canvas. The app around it keeps its own look.
- Preset: App theme, Paper, Slate, Harbor or High contrast. Picking a preset starts over from it; Undo brings your changes back.
- Light and dark: follow the reader’s app setting, or always light, or always dark.
- Colors: background, tiles, text and an accent; plus the six-colour chart palette.
- Type and tiles: the font, corner rounding, shadow, and spacing (compact, comfortable, spacious).
The theme panel checks your colours for readability and lists anything worth a look.
Downloading a dashboard
Section titled “Downloading a dashboard”Anyone who can open a dashboard can download it. Click Download in the header and choose a format:
| Format | What you get |
|---|---|
| The dashboard as one page that fits its content, or split into pages for print (A4 or Letter, landscape or portrait). | |
| Image (PNG) | One tall picture, at standard or high resolution. |
| Data (XLSX) | Each chart’s rows, one sheet per chart, with an About sheet and, when the dashboard has Insights blocks, an Insights sheet containing their text, generation time, scope and notes. |
- It’s what you see. The file uses the filters you’ve set and the theme you’re looking at. The filters are printed on the file, so a reader knows which numbers they’re holding.
- Insights are included. PDF and PNG contain the complete written text; long text continues across print pages. Excel puts it on the Insights sheet. Insights keep their own conditions and period, independently of the chart filters. Downloading never generates text or spends AI credits: when matching written text is unavailable, including after its seven-day cache expires, the file says so. A dashboard with only Insights can also be downloaded.
- Larger dashboards take a moment. A card in the bottom corner shows the step it’s on, with Cancel. You can keep using the page. Closing the tab stops a PDF or image, because your browser draws it.
- On a phone only the Excel file is offered; drawing the dashboard needs more memory than a phone has.
- Link viewers see Download only on links that allow it.
- Your workspace may count downloads each month. If it has reached its limit, the download is refused with a message saying so; an administrator can see the count under Usage.
Downloading a folder as a report
Section titled “Downloading a folder as a report”On a folder page, Download report turns the dashboards in the folder, and in the folders inside it, into one download, including their available written Insights.
- Click Download report beside Share.
- Choose a format: One PDF (a cover with a contents list, then each dashboard), PDFs (zip) (one PDF per dashboard) or Images (zip).
- Untick any dashboards you don’t want, then click Download report.
- Each dashboard is drawn with its own default filters, and each counts as one download toward the monthly limit.
- The report keeps running while you move around the app. It’s handed to you only when every dashboard has had its turn. Cancel keeps nothing.
- A dashboard that can’t be drawn is skipped and named on the card, with Try again for just those.
- Keep the tab open: closing it stops the report, and switching tabs can slow it down.
Saving and conflicts
Section titled “Saving and conflicts”The builder saves as you go. The header shows Saving… then Saved. Undo (Ctrl Z) and redo (Ctrl Shift Z) work across all your edits in the session.
If someone else saves the same dashboard while you’re editing, you’ll see Changed elsewhere and a banner. Click Reload to get their version. Your changes since your last save are lost, so coordinate with them first if you can.
- Model not published: the dashboard’s model has never been published, so it shows “This model isn’t published yet” and no charts load. Publish the model and they appear. New dashboards can only be built on a published model.