From b65ab8c1d328274035138b8da16a4adcdf4dbdbd Mon Sep 17 00:00:00 2001 From: Igor Lukanin Date: Fri, 21 Aug 2026 20:59:08 +0200 Subject: [PATCH 1/2] docs: add the funnel chart type page --- docs-mintlify/docs.json | 1 + .../charts/chart-types/funnel.mdx | 38 +++++++++++++++++++ .../charts/chart-types/index.mdx | 5 ++- 3 files changed, 42 insertions(+), 2 deletions(-) create mode 100644 docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx diff --git a/docs-mintlify/docs.json b/docs-mintlify/docs.json index 2002bbbc437b5..b29e0fae97040 100644 --- a/docs-mintlify/docs.json +++ b/docs-mintlify/docs.json @@ -71,6 +71,7 @@ "docs/explore-analyze/charts/chart-types/area", "docs/explore-analyze/charts/chart-types/scatter", "docs/explore-analyze/charts/chart-types/pie", + "docs/explore-analyze/charts/chart-types/funnel", "docs/explore-analyze/charts/chart-types/heatmap", "docs/explore-analyze/charts/chart-types/boxplot", "docs/explore-analyze/charts/chart-types/table", diff --git a/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx b/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx new file mode 100644 index 0000000000000..d1a4d8a2d4714 --- /dev/null +++ b/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx @@ -0,0 +1,38 @@ +--- +title: Funnel +description: Show how a value narrows from stage to stage, such as signup → activation → purchase. +--- + +Funnel charts draw one bar per stage, centered on a shared midline, with a connector between each adjacent pair of stages. Each bar's width is proportional to its stage's value, so the figure narrows wherever values drop. Best for stage-to-stage conversion: how many users, orders, or events survive each step of a process. + +{/* Screenshot: funnel chart — order counts across four statuses, with stage names and values on the bars and conversion percentages on the connectors. Place directly below this paragraph, full width. (hidden — replace this comment with when image is ready) */} + +## Fields + +A funnel needs exactly two fields, picked on the Fields tab: + +- **Stage** — a dimension (a time dimension works too, bucketed by its grain). Each distinct value becomes one stage. +- **Value** — a measure. It is rolled up per stage, so a result with extra columns still draws one bar per stage. + +Stages keep the order your query returned them in. To reorder stages, adjust the sort in the results table — a stage that grows partway down is real data (re-entry, late-arriving events), so the chart never sorts it away for you. + +A stage whose value is zero still draws, as a thin line in its stage color, so a gap in the data reads as a zero rather than as a missing stage. + +## Conversion percentages + +The connectors between stages carry the funnel's percentages. Two independent toggles in the **Data labels** section of the Style tab control them: + +- **First** — each stage as a share of the first stage, drawn as `36% of first`. On by default. +- **Prev** — each stage as a share of the stage before it, drawn as `20% of previous`. + +Turning both on stacks the two lines on each connector; turning both off leaves the connectors unlabeled. Whichever you select also appears in the tooltip, alongside the stage and value. + +## Data labels + +Each bar carries its stage name and value, both on by default and toggled in the **Data labels** section of the Style tab. The value's number format has its own picker, and one font size governs every label the funnel draws — the bar labels and the connector percentages alike. + +Labels always sit at the bar's center. When a bar is too narrow to hold its label, the text switches from white to a dark color so it stays readable against the page background. + +## Color + +Each stage takes its own color from the palette selected in the **Palette** dropdown on the Style tab, in palette order. diff --git a/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx b/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx index 1783f2f1b7c42..1ea63c877b4f5 100644 --- a/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx +++ b/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx @@ -10,6 +10,7 @@ Cube includes a library of built-in chart types covering the most common visuali - [Area](/docs/explore-analyze/charts/chart-types/area) - [Scatter](/docs/explore-analyze/charts/chart-types/scatter) - [Pie & donut](/docs/explore-analyze/charts/chart-types/pie) +- [Funnel](/docs/explore-analyze/charts/chart-types/funnel) - [Heatmap](/docs/explore-analyze/charts/chart-types/heatmap) - [Boxplot](/docs/explore-analyze/charts/chart-types/boxplot) - [Table](/docs/explore-analyze/charts/chart-types/table) @@ -79,9 +80,9 @@ Otherwise Cube checks these in order and takes the first that matches: The two [bar](/docs/explore-analyze/charts/chart-types/bar) rows are variants of the same chart type, not separate ones. -Pie, area, boxplot and HTML are never recommended — pick them yourself. Pie's shape, one measure +Pie, funnel, area, boxplot and HTML are never recommended — pick them yourself. Pie's shape, one measure across a few categories, is the one Bar already answers, and a bar chart compares those values more -accurately. All four stay available in the picker like any other chart type. +accurately. All five stay available in the picker like any other chart type. ### When nothing is recommended From 375cb8de36b6b6095d9415a90f9239558ea0b6cc Mon Sep 17 00:00:00 2001 From: Igor Lukanin Date: Fri, 21 Aug 2026 21:09:49 +0200 Subject: [PATCH 2/2] docs: link the funnel palette to the shared palettes page, document its legend, and reflow the recommendation rationale --- .../explore-analyze/charts/chart-types/funnel.mdx | 12 +++++++++++- .../explore-analyze/charts/chart-types/index.mdx | 8 +++++--- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx b/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx index d1a4d8a2d4714..92546ac5a18ca 100644 --- a/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx +++ b/docs-mintlify/docs/explore-analyze/charts/chart-types/funnel.mdx @@ -14,6 +14,8 @@ A funnel needs exactly two fields, picked on the Fields tab: - **Stage** — a dimension (a time dimension works too, bucketed by its grain). Each distinct value becomes one stage. - **Value** — a measure. It is rolled up per stage, so a result with extra columns still draws one bar per stage. +{/* Screenshot: Fields tab with the Stage and Value selectors bound. Place inline, 50% width, right-aligned. (hidden — replace this comment with when image is ready) */} + Stages keep the order your query returned them in. To reorder stages, adjust the sort in the results table — a stage that grows partway down is real data (re-entry, late-arriving events), so the chart never sorts it away for you. A stage whose value is zero still draws, as a thin line in its stage color, so a gap in the data reads as a zero rather than as a missing stage. @@ -27,6 +29,8 @@ The connectors between stages carry the funnel's percentages. Two independent to Turning both on stacks the two lines on each connector; turning both off leaves the connectors unlabeled. Whichever you select also appears in the tooltip, alongside the stage and value. +{/* Screenshot: Style tab Data labels section with the First and Prev toggles. Place inline, 50% width, right-aligned. (hidden — replace this comment with when image is ready) */} + ## Data labels Each bar carries its stage name and value, both on by default and toggled in the **Data labels** section of the Style tab. The value's number format has its own picker, and one font size governs every label the funnel draws — the bar labels and the connector percentages alike. @@ -35,4 +39,10 @@ Labels always sit at the bar's center. When a bar is too narrow to hold its labe ## Color -Each stage takes its own color from the palette selected in the **Palette** dropdown on the Style tab, in palette order. +Each stage takes its own color from the palette selected in the **Palette** dropdown on the Style tab, in palette order. See [Palettes](/docs/explore-analyze/charts/configuration/color-and-stacking#palettes) for the built-in palettes and how to define a custom one. + +{/* Screenshot: Style tab with the Palette dropdown open, showing the built-in discrete palettes. Place inline, 50% width, right-aligned. (hidden — replace this comment with when image is ready) */} + +## Legend + +A legend naming each stage in its palette color is available in the **Legend** section of the Style tab, along with its placement. diff --git a/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx b/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx index 1ea63c877b4f5..707b5ee0a6815 100644 --- a/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx +++ b/docs-mintlify/docs/explore-analyze/charts/chart-types/index.mdx @@ -80,9 +80,11 @@ Otherwise Cube checks these in order and takes the first that matches: The two [bar](/docs/explore-analyze/charts/chart-types/bar) rows are variants of the same chart type, not separate ones. -Pie, funnel, area, boxplot and HTML are never recommended — pick them yourself. Pie's shape, one measure -across a few categories, is the one Bar already answers, and a bar chart compares those values more -accurately. All five stay available in the picker like any other chart type. +Pie, funnel, area, boxplot and HTML are never recommended — pick them yourself. Pie's shape, one +measure across a few categories, is the one Bar already answers, and a bar chart compares those +values more accurately. A funnel additionally asserts that its stages are sequential steps of one +process, which the shape of a query does not reveal. All five stay available in the picker like any +other chart type. ### When nothing is recommended