Skip to content

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.

  • 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.
  1. Go to Dashboards (or a folder page) and click New dashboard.
  2. Give it a Name, pick the Data model its charts use, and optionally add a description.
  3. The builder opens. Add charts from the model’s fields, no SQL needed.
Where it lands

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.

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.

AreaWhat 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.
Back to the dashboard’s settings

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.

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.

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.

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.

ChartGood forWells
BarComparing values across categoriesCategory, 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.
LineA trend over days, months, quarters or yearsTime axis, Values, optional Split by
AreaA trend, and how each part contributes to itTime axis, Values, optional Split by
KPIOne headline number, with its change or a targetValue, optional Target, optional Trend over (a date, for a sparkline)
DonutHow a whole splits by category or statusSlices, Value
ComboA value as bars and a rate as a line, e.g. revenue and marginCategory, Bars (up to 3), Lines (up to 3)
TableDetailed values to sort and highlightColumns

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.

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.

The Style tab shows only the sections that apply to the chart type:

SectionOptions
HeaderShow or hide the title; a subtitle (e.g. the period it covers)
NumbersHow values are formatted
ColorsA 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 labelsLegend position (auto, top, bottom, right, hidden); value labels on every point, the latest, or the high and low
AxesAxis labels, gridlines, axis titles, fixed axis start and end
Reference linesA target or average line, with its own label. A long label is shortened to fit the chart and sits above the line.
Order and limitOrder (the field’s own order, A to Z, largest first, smallest first); show only the top N and group the rest as “Other”
SeriesSide by side, stacked, or 100%
ScalePut lines on their own right-hand scale (bar, line, area and combo)
LineSmooth, straight or step; point markers
DatesDate 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

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.

FilterWhat it does
Pick valuesChoose regions, statuses, products… as a dropdown, a list or buttons. Optionally allow several values, or exclude the picked ones.
Text searchMatch part of a name (“contains”).
Date rangeLast 30 days, this quarter, year to date, or custom.
Single dateOn, before or after one date.
Number rangeBetween two values, on a slider.
Number comparisonAt least, at most, or exactly a value.
Time grainRegroup time charts by day, week, month…
Top NShow 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.

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.
Panel chats are shared

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.

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.

  1. In the dashboard builder, click Insights on the insert bar. Select the new block to open its inspector.
  2. Under What it’s about, choose a Subject, such as Salesperson or Region. Each value of that field is something the summary can compare.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
Insights have their own scope

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.

  • 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.

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.

Anyone who can open a dashboard can download it. Click Download in the header and choose a format:

FormatWhat you get
PDFThe 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.

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.

  1. Click Download report beside Share.
  2. Choose a format: One PDF (a cover with a contents list, then each dashboard), PDFs (zip) (one PDF per dashboard) or Images (zip).
  3. 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.

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.