What you'll do#
Open a dashboard you're authorized to see, check how fresh the data is, apply filters, switch pages, and interpret the indicators. This guide covers viewing. Editing and publishing require their own actions and permissions.
Opening a dashboard means viewing it
The default entry is Viewing mode. Editing is an explicit action: the
Edit button takes you to the editor (the address gets ?modo=editar). If you only
view, you never land in the editor by accident.
Before you start#
- Have access to the dashboard, in the right company/workspace.
- To follow the example, use a dashboard from the fictional workspace Comércio Aurora Ltda.
- The dashboard needs to have data. If ingestion hasn't finished yet, check the refresh status before interpreting an empty result as "there were no sales".
- You don't need to enable AI to view BI.
Step by step#
1. Find the dashboard
Go to BI → Workspace (the dashboard list) or use global search (⌘K / Ctrl+K). Check the name and context before opening it.
2. Open it in read mode
Click the dashboard. The line below the title ends in Viewing: filters, clicks, and zoom work, and the dashboard layout doesn't change. If you can also edit, the pencil (Edit …) appears on the right.
3. Check how fresh the data is
The line below the title starts with Data from …. For details, open More actions ▸ Dashboard details: there you'll find four different facts, with different labels — Data: (the last data refresh), Next data refresh:, Published:, and Last edit:. A freshly saved dashboard can have a Last edit from now and Data from yesterday — don't confuse the two.
4. Read the indicators in context
Check the unit, period, and comparison baseline before concluding anything. If there's a percentage change, read it against what it compares to.
5. Apply filters
Use the dashboard's filters. When the dashboard has Hold filters until “Apply” checked, the change stays pending until you use Apply (or Discard). Outside that mode, the dashboard updates on its own. To empty the filters, use Clear; to go back to the dashboard's default, use Reset.
6. Switch pages or open a detail
The dashboard's pages appear as tabs with each page's name (or as a side menu, when the dashboard was set up that way). Not every chart has a drill-down: use what's enabled on the dashboard.
7. Click a chart and use right-click
Clicking a bar filters the other charts (cross-filtering). Right-click opens the chart menu: Focus mode (full screen), See records (underlying rows), Export this visual as CSV, Save as image, and Notes on this visual. All of it in Read a dashboard.
The screen, in read mode#
Notice three things the screen separates on purpose:
- the mode (Viewing) is written next to the data date;
- Edit is its own button (the pencil), on the right — viewing never lands in the editor;
- the Data from … line is the date of the last data materialization, not of the last dashboard edit.
If you also edit, the editor is another screen: it shows the searchable visuals gallery, the properties pane for the selected object (Data · Format · Interactions), and the View dashboard and Publish actions in the header.
On phone, tablet, and TV#
The dashboard adapts to the device:
- Phone (less than 640 px): the phone layout the owner arranged applies; without it, the indicators stack. Filters remain reachable and reading doesn't require horizontal scrolling.
- Tablet (640 to 1023 px): the tablet layout applies, when there is one; without it, the desktop layout.
- Touch: tapping a bar or point opens the tooltip with the value; tapping outside closes it.
- TV: through the TV link, the dashboard fills the whole screen and rotates pages on its own — see TV link.
What each date label means#
| Label on screen | What it tells you |
|---|---|
| Data: | When the dashboard's data was last materialized. On a continuous-refresh dashboard, it shows as continuous refresh. With no completed load, it shows no data yet. |
| Next data refresh: | When the next refresh is scheduled. With the schedule paused, it shows inactive. |
| Published: | When the current version of the dashboard was published, or not published yet. |
| Last edit: | When someone changed the layout/definition — and who, when the audit log knows. It's not a data refresh. |
If the dashboard has no data yet, the screen itself explains: "This dashboard hasn't had a completed data refresh yet. Use 'Refresh now' or wait for the next scheduled refresh."
About number precision
The KPI card shows the full number, without abbreviation. Abbreviation as k/M/B only appears on the charts' axis labels — in that case, the exact value appears when you hover over the point or bar, in the chart tooltip. There's currently no dedicated "see full value" button.
Export and share#
Everyday buttons sit in the header itself, on the right: Refresh now, Print preview, Excel, PDF, and PPT. The rest is under More actions (on a narrow screen, Refresh now and Print preview move there too):
- Export Excel: Summary (as on screen) and Underlying data (detail).
- Export PDF: PDF. Depends on the plan — included in Business and Scale.
- PowerPoint: Presentation (.pptx).
- share — the link opens the sharing screen.
Real conditions: exporting requires a role with export permission (viewers can't export), an up-to-date subscription, and the capability turned on. When something is unavailable, a tooltip next to the button says why — for example "Your plan doesn't include this feature." or "Feature unavailable until the subscription is settled." Each button is explained in Dashboard header actions.
Sharing is the workspace owner's decision. Anyone who isn't the owner sees: "Only the workspace owner decides how this dashboard is shared." The three doors are 1 · Secret link (with the TV link right below), 2 · Embed in your app, and 3 · Publish to the web (indexable) — and all of them require the dashboard to be published.
A secret link is not access control
A hard-to-guess address doesn't replace authentication. Publishing to the web makes the dashboard indexable. Think about the audience before opening the door.
Expected result#
You find the dashboard, understand period, unit, and refresh, use filters without changing the dashboard content, and the numbers stay consistent with the data and with your access profile.
If something goes wrong#
| Symptom | What to check | Next action |
|---|---|---|
| Dashboard not found | Account/workspace, link, and permission | Ask the workspace owner for access |
| Empty indicator | Filters, period, and the Data: label | If it says no data yet, run the load before interpreting |
| Number different from expected | Unit, formula, slice, source, and last refresh | See semantic model |
| Edit doesn't appear | Role and permission on the dashboard | Viewing doesn't require editing; ask for edit permission if you need it |
| Filter had no effect | Whether the dashboard has Hold filters until “Apply” checked | Use Apply filters |
| On the phone the tooltip doesn't open | The chart uses a tooltip page, which only opens with a mouse | Tapping shows the regular tooltip; for the tooltip page, use a computer |
| Export unavailable | Format, plan, and role | PDF is for Business/Scale; exporting requires a role with permission |
| Sharing denied | Whether you're the workspace owner and whether the dashboard is published | Ask the owner |
Limits and costs#
- Viewing a materialized dashboard doesn't query the datalake and costs R$ 0.
- A continuous-refresh dashboard queries the datalake (with a cache of up to 10 min) and can generate cost — see cost and forecast.
- Refresh now is an expensive action and goes through the subscription check.
Back to the app#
- Open the dashboard list: BI → Workspace
- Go to Home: Overview
Next task#
- If you build dashboards: Build your first dashboard
- If AI is enabled: Ask your data
- To go further in reading: Read a dashboard
Last reviewed: 2026-10-03. The screenshots on this page come from the delivered
version, in a demo environment with fictional data (the project seed's synthetic
workspace), at 1366×768 and 390×844 viewports. The provenance of each
image — file, SHA-256, route, commit, role, and privacy review — is
in the screenshot manifest e2e/baseline/galeria-v3.json. A screenshot from a
local environment documents the interface; it doesn't prove execution in the cloud. The
text examples use the fictional workspace Comércio Aurora Ltda
(aurora). No customer data appears in this documentation.