From 3d955f28725d140e657a496507d4325ab1d197fd Mon Sep 17 00:00:00 2001 From: igorlukanin <3852894+igorlukanin@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:46:36 +0200 Subject: [PATCH 1/4] docs: comments on a chart data point --- .../explore-analyze/dashboards/comments.mdx | 36 ++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx index 2229a2e30d9b8..89948fcf15d58 100644 --- a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx +++ b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx @@ -1,6 +1,6 @@ --- title: Comments -description: Discuss a dashboard with your team in threaded comments. Reply, resolve, react, and mention teammates, on the whole dashboard or on one chart. +description: Discuss a dashboard with your team in threaded comments. Reply, resolve, react, and mention teammates, on the whole dashboard, on one chart, or on one data point. --- Comments let your team discuss a [published dashboard][ref-dashboards] on the @@ -72,6 +72,40 @@ chart. In the list, a thread about a chart shows the chart's name: threads stay on the dashboard and you can still read them. If the chart comes back to the dashboard, its threads attach to it again. +## Comments on a data point + +A thread can also be about one data point on a chart, for example one bar or one +point on a line. Click the data point and choose **Comment on this point**. If +the chart supports drill-down, the same menu also has **Drill down**. A popover +opens next to the data point. It shows the data point and its value, and the box +reads **Start a thread on this point…**. + +{/* TODO: screenshot — a bar chart with a pin above one bar and the point popover open */} + +A data point with threads shows a pin above it. The pin shows the number of open +threads. A pin with only resolved threads shows a check mark. Hover the pin to +see the counts, and click it to open the popover with all threads on that data +point. To see the threads in the panel, click **Open in comments panel** in the +popover. + +In the panel, a thread about a data point shows the data point under the chart's +name. Click it to show the data point on the chart. + +The data point is identified by its measure and its dimension values, not by its +position. When the chart changes, Cube finds the data point again: + +- If the value changed since the thread was started, the thread shows both + values, for example **12,480 (as seen on Oct 11, 2026)** and **14,020 (now)**. +- If the data point is not on the chart, for example because a filter removed + it, the pin is not shown. In the panel, the data point is grey and shows the + value from when the thread was started. When the data point comes back, the + pin comes back too. +- A change of time grain, for example from month to week, makes a different + data point. Threads on the old data point show as not on the chart. + +Comments on a data point are not available on **Table**, **KPI**, **Map**, and +Sankey charts. On these charts, comment on the whole chart instead. + ## Editing and deleting To change your comment, open its **More actions** (`⋯`) menu and choose From cdb44610bee7b76305a18589a725b089c019b0f9 Mon Sep 17 00:00:00 2001 From: Igor Lukanin Date: Fri, 23 Oct 2026 17:34:40 +0200 Subject: [PATCH 2/4] docs: list every chart type without comments on a data point --- .../docs/explore-analyze/dashboards/comments.mdx | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx index 89948fcf15d58..86e174822b5e2 100644 --- a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx +++ b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx @@ -84,7 +84,7 @@ reads **Start a thread on this point…**. A data point with threads shows a pin above it. The pin shows the number of open threads. A pin with only resolved threads shows a check mark. Hover the pin to -see the counts, and click it to open the popover with all threads on that data +see how many threads are open and resolved, and click it to open the popover with all threads on that data point. To see the threads in the panel, click **Open in comments panel** in the popover. @@ -103,8 +103,10 @@ position. When the chart changes, Cube finds the data point again: - A change of time grain, for example from month to week, makes a different data point. Threads on the old data point show as not on the chart. -Comments on a data point are not available on **Table**, **KPI**, **Map**, and -Sankey charts. On these charts, comment on the whole chart instead. +Comments on a data point are not available on **Table**, **KPI**, **HTML**, +**Map**, **Sankey**, and **Funnel** charts. On a **Boxplot** chart, you can +comment only on the outlier points. On these charts, comment on the whole chart +instead. ## Editing and deleting From 0b403111fc62d07539f2b2a7fb0ea1b422c5db8d Mon Sep 17 00:00:00 2001 From: igorlukanin <3852894+igorlukanin@users.noreply.github.com> Date: Fri, 23 Oct 2026 17:37:50 +0200 Subject: [PATCH 3/4] docs: mention data points in the comments intro Co-Authored-By: Claude Opus 5.5 --- .../docs/explore-analyze/dashboards/comments.mdx | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx index 86e174822b5e2..9c87036ed29b0 100644 --- a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx +++ b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx @@ -4,10 +4,11 @@ description: Discuss a dashboard with your team in threaded comments. Reply, res --- Comments let your team discuss a [published dashboard][ref-dashboards] on the -dashboard itself. Start a thread about the whole dashboard or about one chart. -Other people can reply to it, react to it, and resolve it when the question is -answered. Mention a teammate with `@` to send them a notification. Everyone -who wrote in a thread gets a notification when someone replies to it. +dashboard itself. Start a thread about the whole dashboard, one chart, or one +data point on a chart. Other people can reply to it, react to it, and resolve it +when the question is answered. Mention a teammate with `@` to send them a +notification. Everyone who wrote in a thread gets a notification when someone +replies to it. Comments are on by default. An admin can turn them off for your account. See @@ -84,9 +85,9 @@ reads **Start a thread on this point…**. A data point with threads shows a pin above it. The pin shows the number of open threads. A pin with only resolved threads shows a check mark. Hover the pin to -see how many threads are open and resolved, and click it to open the popover with all threads on that data -point. To see the threads in the panel, click **Open in comments panel** in the -popover. +see how many threads are open and resolved, and click it to open the popover +with all threads on that data point. To see the threads in the panel, click +**Open in comments panel** in the popover. In the panel, a thread about a data point shows the data point under the chart's name. Click it to show the data point on the chart. From f7841752488b2cb46c4d5d634fd27f4789b3eca6 Mon Sep 17 00:00:00 2001 From: Igor Lukanin Date: Fri, 23 Oct 2026 23:39:28 +0200 Subject: [PATCH 4/4] docs: place the chart-level fallback before the Boxplot note and use US spelling --- docs-mintlify/docs/explore-analyze/dashboards/comments.mdx | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx index 9c87036ed29b0..d52ca9d75cfc6 100644 --- a/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx +++ b/docs-mintlify/docs/explore-analyze/dashboards/comments.mdx @@ -98,16 +98,15 @@ position. When the chart changes, Cube finds the data point again: - If the value changed since the thread was started, the thread shows both values, for example **12,480 (as seen on Oct 11, 2026)** and **14,020 (now)**. - If the data point is not on the chart, for example because a filter removed - it, the pin is not shown. In the panel, the data point is grey and shows the + it, the pin is not shown. In the panel, the data point is gray and shows the value from when the thread was started. When the data point comes back, the pin comes back too. - A change of time grain, for example from month to week, makes a different data point. Threads on the old data point show as not on the chart. Comments on a data point are not available on **Table**, **KPI**, **HTML**, -**Map**, **Sankey**, and **Funnel** charts. On a **Boxplot** chart, you can -comment only on the outlier points. On these charts, comment on the whole chart -instead. +**Map**, **Sankey**, and **Funnel** charts. On these charts, comment on the whole +chart instead. On a **Boxplot** chart, you can comment only on the outlier points. ## Editing and deleting