Back to Cube

Dashboards

docs-mintlify/docs/explore-analyze/dashboards/index.mdx

1.6.654.1 KB
Original Source

Dashboards let you select and organize reports from your workbooks into polished, shareable views for your team and stakeholders. Transform your exploratory analysis into production-ready deliverables by choosing which insights to highlight and present.

Use cases

Dashboards enable you to:

  • Monitor key metrics – Display critical business indicators that refresh with live data
  • Distribute analysis – Package your findings into reports for regular distribution
  • Build data tools – Develop specialized applications powered by your semantic layer
  • Present insights – Showcase important discoveries in a polished, accessible format

How it works

In the dashboard builder inside your workbook, select the reports you want to include and arrange them on the canvas alongside other widgets to tell your data story, then publish the dashboard. This gives stakeholders direct access to the insights that matter most, without the complexity of the underlying analysis.

Linking between dashboards

Dashboards can link to one another. When a table widget shows a dimension that has links defined in the data model, left-clicking a cell opens a menu with those links: a drill-in link (dashboard:) navigates to another dashboard in the same deployment, filtered by the values in the clicked row, and an external link (url:) opens a URL. This is how you build overview → detail flows — click a row in a summary dashboard to jump straight to a focused dashboard scoped to that row.

Links are declared once on the dimension in the data model (not configured per-dashboard), so every table that shows that dimension — in dashboards, workbooks, embedded dashboards, and Explore — offers the same links. A drill-in link targets a dashboard by its slug; see Dimensions → Links to define them.

Dashboard slug

A dashboard can have a slug — a short, stable, human-readable identifier (e.g. orders-detail) used to link to it from the data model. Data-model dimension links with a dashboard: value reference a dashboard by its slug to drill into it.

To set it, open the dashboard in the builder, open the options sidebar, and fill the Slug field. Slugs are unique per deployment and are resolved within the current deployment, so the same model works across environments. The dashboard's own URL is unaffected (it stays publicId-based).

<Note>

There is no required order between the model and the dashboard. You can reference a slug from a dashboard: link in the data model before any dashboard uses it, or set a dashboard's slug before any link references it — neither breaks. A link whose slug doesn't (yet) resolve is simply skipped in the cell menu, and starts working as soon as a dashboard in the deployment claims that slug. (If you later clear or change a slug that links still reference, the options sidebar warns you to update those links.)

</Note>

Download as PNG or PDF

Open a published dashboard, click the More actions () button in the header, and choose Download as PNG or Download as PDF. The file is named after the dashboard's title.

The download is a server-rendered snapshot — Cube re-opens the dashboard, waits for every widget to finish rendering, and captures the result. This can take up to a couple of minutes for large dashboards. Filter or time grain selections you change in your browser before clicking Download are not applied; the snapshot uses the dashboard's saved state.

Available to users with Manage permission on the workbook that owns the dashboard. The same screenshot mechanism powers PNG/PDF attachments on notifications sent after a scheduled refresh.