> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cube.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Funnel

> 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.

## 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.

## Direction

The **Direction** row at the top of the Style tab decides which way the stages progress:

* **Vertical** — stages run top to bottom, each bar spanning the width. The default.
* **Horizontal** — stages run left to right, each bar spanning the height. Useful when stage names are long, or alongside other left-to-right charts.

The taper, the connectors and every label carry over unchanged; only the axes swap.

Direction is greyed out until the chart has both a stage field and a value field.

## 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. See [Palettes](/docs/explore-analyze/charts/configuration/color-and-stacking#palettes) for the built-in palettes and how to define a custom one.

## Legend

A funnel draws no legend by default — every bar already carries its stage name, so a legend would repeat it. Turn one on in the [**Legend**](/docs/explore-analyze/charts/configuration/color-and-stacking#legend) section of the Style tab, which also sets its placement. It names each stage in its palette color.