> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-9d6f9427.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Funnel chart

> Use funnel charts to show pipeline performance, product conversion metrics, or any process with discrete stages.

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-9d6f9427/7xc3txAYWVLt_XVq/images/references/chart-types/funnel-chart.png?fit=max&auto=format&n=7xc3txAYWVLt_XVq&q=85&s=2e3c7ca0e17c3e902681e9e83595b7cf" alt="" width="1406" height="1346" data-path="images/references/chart-types/funnel-chart.png" />
</Frame>

Funnel charts work well for showing pipeline performance, product conversion metrics, onboarding flows, or any other process where things move from one discrete stage to another.

To use a funnel chart, you should have discrete stages of a process and numeric counts of entities in each stage.

The funnel will show the count at each stage and the percentage that number represents of the starting count, making it easy to visualize the proportion moving from one stage to the next.

## General settings

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-9d6f9427/7xc3txAYWVLt_XVq/images/references/chart-types/funnel-chart-config.png?fit=max&auto=format&n=7xc3txAYWVLt_XVq&q=85&s=c0426742d2ff2795ad1ef3ec556891cd" alt="" width="792" height="634" data-path="images/references/chart-types/funnel-chart-config.png" />
</Frame>

With the Lightdash funnel chart, you can use either a row or a column to describe the stages in your funnel.

Use the `Data orientation` switch to specify which orientation you would like to use.

When `rows` is selected, each row of your data represent one step. The first column in the data will be treated as the labels for the steps, and you can choose which **numeric** column to treat as the value of the step.

When `columns` is selected, you should have a numeric column for each step you want to display. Only the first row of data will be represented and the column names will be used as the step labels. Non-numeric columns will be ignored.

## Referencing the active granularity in labels

Step labels support a `${table_field.granularity}` placeholder that resolves to the active date granularity (for example `day`, `week`, `month`) — including the granularity selected via [date zoom](/guides/date-zoom). Click the **insert date granularity** icon inside the editable step label field to insert the placeholder without typing it manually. See [Referencing the granularity in chart labels](/guides/date-zoom#referencing-the-granularity-in-chart-labels) for the full syntax and supported labels.

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-9d6f9427/V_l2vWADxQjV7IYC/images/Screenshot-2026-06-25-at-12.15.28.png?fit=max&auto=format&n=V_l2vWADxQjV7IYC&q=85&s=973960f91a5b4fd8415d72fc95f095a1" alt="Screenshot 2026 06 25 At 12 15 28" width="770" height="374" data-path="images/Screenshot-2026-06-25-at-12.15.28.png" />
</Frame>

<Warning>
  Step labels are per-step overrides keyed to a specific category value. Date zoom re-buckets the underlying dates (for example, a monthly `2024-07` step becomes a weekly `2024-07-15` step), so an override set at one granularity stops matching after a viewer zooms to another and the custom label silently falls back to the raw value.
</Warning>
