cube-js · vasilev-alex · Sep 16, 2026 · Sep 16, 2026 · Sep 16, 2026 · Sep 16, 2026
@@ -7,8 +7,9 @@ Admins, and users with the [**Access chat history**][ref-custom-roles] custom
 role permission, can view every user's chat conversations for a deployment.
 
 It's possible to search specific chats by the first message content or chat UUID.
-You can also filter the list by user type, creation date, and source
-(**Web**, **MCP**, **Slack**, **Scheduled**, or **API**).
+You can also filter the list by user type, creation date, and source — **Web**
+(including Analytics Chat and the Excel/Google Sheets add-in panes), **MCP**,
+**Slack**, **Scheduled**, or **API**.
 
 <video
   autoPlay

@@ -39,7 +39,7 @@ Each dashboard answers a different question about your account's usage.
 
 | Dashboard | Description |
 | --- | --- |
-| **Overview** | High-level health and adoption at a glance: requests, error rate, cache hit rate, response time, AI activity, and top tenants. |
+| **Overview** | High-level health and adoption at a glance: requests, error rate, cache hit rate, response time, and AI activity. |
 | **Query Activity & Performance** | Query volume by API type, latency percentiles, execution-stage breakdown, slowest queries, errors, and activity heatmap. |
 | **Users & Adoption** | Active users over time, new vs. returning users, engagement frequency, seat utilization, and dormant accounts. |
 | **AI & Token Tracking** | AI messages and conversations by surface, AI adoption, token consumption with estimated cost, and latency. |
@@ -51,18 +51,29 @@ Usage Analytics runs the full Cube application in
 the pre-built dashboards, you get the complete authoring experience: explore
 the usage data, create workbooks, and assemble your own dashboards from it.
 
-Your dashboards query the same three curated views that power the pre-built
-ones. Anything you build stays private unless you share it.
+Your dashboards can query every curated view below — including the five
+dashboard views, which no pre-built dashboard uses. Anything you build stays
+private unless you share it.
 
 | View | What it contains |
 | --- | --- |
-| **API Requests** | Every query hitting your deployments' data APIs, with timing, caching, errors, and the user, tenant, and deployment behind each request. |
+| **API Requests** | Every query hitting your deployments' data APIs, with timing, caching, and errors. `tenant_id` here is your own Cube account, not an embed tenant — row-level security pins every query to it, so this view can't be used to compare your embed tenants against each other. For per-request detail on one deployment, see [Query History](/admin/monitoring/query-history) instead. |
 | **AI Usage** | AI messages grouped into conversations and sessions, with context, token consumption, estimated cost, and latency. |
 | **Users & Adoption** | Users and their engagement: sign-ups, active users, activity frequency, seat utilization, and dormant accounts. |
-
-The API Requests view includes the security context behind each request, so
-embedded analytics customers can slice usage by tenant — for example, to find
-the heaviest tenants or compare per-tenant latency and cache efficiency.
+| **Dashboard Usage** | Every dashboard in your account — opens, viewers, surface, and when it was last touched — including ones nobody has opened yet. |
+| **Dashboard Engagement** | One row per view session: dwell time and whether the viewer did anything at all. |
+| **Dashboard Interactions** | In-dashboard actions: filter changes, refreshes, exports, drill-ins, chat opens. |
+| **Dashboard Authoring** | Publishes and deletions — who ships dashboard changes and who removes them. |
+| **Dashboard Inventory** | A daily snapshot of the dashboard estate, for trends over time. |
+
+If you embed Cube for multiple customers, Dashboard Usage carries
+`viewer_embed_tenant` — which of your embed customers' users did the looking.
+Dashboard Usage, Authoring, and Inventory all carry `embed_tenant_name` — which
+embed tenant the content itself belongs to. The two can disagree, since a viewer
+from one customer can open a dashboard that lives in another partition. Dashboard
+Engagement and Dashboard Interactions are collected client-side and are suppressed entirely
+for embedded Creator Mode, so they carry no embed-tenant breakdown and return
+nothing for embed-only traffic — that's suppression, not zero usage.
 
 ## Query programmatically
 

@@ -119,7 +119,7 @@ Either grant **Full access** (a shortcut that enables every current and future d
 | Data Model  | Edit data model                     | Edit the data model on any branch, including the main/deploy branch. Allows committing and merging to main, force-syncing main, and starting dev mode against main.       |
 | Data Model  | Edit data model on dev branches     | Edit the data model only on non-default branches. Blocks any write that targets the main/deploy branch (including merging to main).                                       |
 | Monitoring  | Access query history                | View deployment query history, performance, and traces.                                                                                                                   |
-| Monitoring  | Access chat history                 | View other users' Analytics Chat conversations for the deployment (**Admin → Chats History**).                                                                           |
+| Monitoring  | Access chat history                 | View other users' chat conversations for the deployment, including Analytics Chat and the Excel/Google Sheets add-in panes (**Admin → Chats History**).                  |
 | Data Export | Download data                       | Download query results as CSV from workbooks, Analytics Chat, and published dashboards. Granted by default to the built-in Viewer, Explorer, and Developer roles. See [Data download controls][ref-data-download-controls]. |
 
 When **Full access** is checked, the granular checkboxes appear checked and disabled — granting Full access today also covers any deployment-scoped permissions added in the future.

@@ -17,6 +17,7 @@ The AI agent interprets your questions, generates queries against your semantic
 - **Semantic model integration** – All queries run against your semantic model with proper access control and security, honoring the active [security context](/docs/explore-analyze/workbooks/querying-data#applying-a-security-context)—including an override applied by a developer or admin
 - **Queued messages** – Send follow-up messages while the agent is still processing
 - **Save your results** – Ask the agent to save a result as a [report](/docs/explore-analyze/workbooks) inside a workbook, or as a standalone [exploration](/docs/explore-analyze/explore#saving-explorations) when you don't want to create a workbook
+- **Organize saved work** – Ask the agent to save an exploration into a specific [folder](/docs/organize-content/folders), or to list, create, rename, move, or delete folders in your workspace — folder actions run immediately, and deletion [destroys less than the Workspace page but checks less too](/docs/organize-content/folders#deleting-folders)
 - **Link saved artifacts** – The agent can link an existing exploration, workbook, or dashboard to the conversation, on request or automatically when it creates or edits one, so you can reopen it from the thread later
 
 ## Discover available fields

@@ -130,7 +130,8 @@ that owns it; exporting a single chart requires the **Download data**
 permission. Both are hidden entirely when an admin turns off the account-wide
 [data download controls][ref-data-download-controls]. The same screenshot
 mechanism powers PNG/PDF attachments on [notifications][ref-notifications] sent
-after a [scheduled refresh][ref-scheduled-refreshes].
+after a [scheduled refresh][ref-scheduled-refreshes], and is also available
+programmatically — see the [Control Plane API][ref-control-plane-api].
 
 [ref-workbooks]: /docs/explore-analyze/workbooks
 [ref-widgets]: /docs/explore-analyze/dashboards/widgets
@@ -139,3 +140,4 @@ after a [scheduled refresh][ref-scheduled-refreshes].
 [ref-notifications]: /docs/explore-analyze/notifications
 [ref-scheduled-refreshes]: /docs/explore-analyze/scheduled-refreshes
 [ref-data-download-controls]: /admin/users-and-permissions/roles-and-permissions#restricting-data-downloads
+[ref-control-plane-api]: /reference/control-plane-api#apiv1deploymentsdeployment_iddashboard-exports
@@ -181,6 +181,30 @@ change.
 
 {/* TODO: screenshot — a pivoted exploration with the Total row on the sheet */}
 
+### Row totals
+
+The **Row totals** switch, next to **Column totals** on the **Display** tab,
+appends a bold **Total** column at the right of the written range, totaling
+each row across the pivot columns. It needs a measure in the query and a
+dimension on **Columns** to pivot across — it's disabled, with a tooltip
+explaining which is missing, until both are set. With measures on **Columns**,
+each measure gets its own total column; with measures on **Rows**, a single
+total column covers them all, since each row already holds one measure.
+
+Like column totals, each total comes from a separate query grouped by the
+opposite zone, so the same rules apply: correct for non-additive measures,
+window-function [calculations][ref-calculated-fields] excluded, measure
+filters dropped and dimension filters kept, and totals taken over the query's
+full result rather than the rows on the sheet. With both switches on,
+the cell where they meet holds a grand total across the whole result, from a
+third query with neither zone kept.
+
+Row totals are saved with the exploration and survive **Refresh** too; with
+auto-run off, toggling the switch waits for **Run** like any other display
+change.
+
+{/* TODO: screenshot — a pivoted exploration with the Total column on the sheet */}
+
 When your exploration is ready, click **Save** to add it to your workspace. You
 can then [work with the exploration](#work-with-explorations) from the add-on.
 To discard an unsaved exploration instead, choose **Delete exploration** from
@@ -264,17 +288,28 @@ The chat pane is currently in preview, and the tools it can call may still chang
 With chat enabled, the add-on's sidebar gains a pane that can act on the
 spreadsheet, not just answer questions about it. Ask it to run a query and
 place the results, or refresh or clear a placed exploration. It can also
-create, rename, or delete a sheet.
+create, rename, or delete a sheet, and organize your saved explorations into
+[folders][ref-folders] — list, create, rename, move, or delete one on
+request. Deleting one this way [destroys less than the Workspace page but checks
+less too][ref-deleting-folders].
+
+Drag a saved exploration or an unsaved draft from the spreadsheet's home onto
+the chat composer to attach it as context for your next question.
 
-Before any destructive or ambiguous action — writing over an occupied area,
-clearing a placement, renaming or deleting a sheet — the pane asks you to
-confirm first. A query the agent places lands as an **unsaved** exploration;
-save it yourself if you want to keep it.
+Before any destructive or ambiguous action on the sheet — writing over an
+occupied area, clearing a placement, renaming or deleting a sheet — the pane
+asks you to confirm first. A query the agent places lands as an **unsaved**
+exploration; save it yourself if you want to keep it. Folder actions are the
+exception: creating, renaming, moving, or deleting one runs immediately,
+without a confirmation step.
 
 Answers are tables, not charts — the chat pane doesn't render
-visualizations. Chat history is stored locally per spreadsheet, on the
-device where you had the conversation — it isn't available if you open the
-file elsewhere.
+visualizations. Past conversations are listed under **Chat History** in the
+pane — every conversation you've had in the add-on on this deployment, not
+just the current spreadsheet's — and sync with your Cube account, so they're
+available from any device. Like other conversations, they're readable by
+admins and anyone with the **Access chat history** permission under
+[Chats History](/admin/monitoring/chats-history).
 
 {/* TODO: screenshot — the chat pane open in the add-on sidebar */}
 
@@ -288,3 +323,5 @@ file elsewhere.
 [ref-sql-api-enabled]: /reference/core-data-apis/sql-api#cube-cloud
 [ref-explorations]: /docs/explore-analyze/explore#saving-explorations
 [ref-calculated-fields]: /docs/explore-analyze/workbooks/calculated-fields
+[ref-folders]: /docs/organize-content/folders
+[ref-deleting-folders]: /docs/organize-content/folders#deleting-folders