# Funnel

A funnel chart shows how a single numeric metric changes across an ordered sequence of steps. Use it to compare stages and measure drop-off, growth, or stability.

It’s ideal for:

* conversion or pipeline steps
* request flows and stage transitions
* resource consumption stages
* stability checks over time (step = timestamp)

### What a funnel chart represents

Each row in the funnel represents one **step** (for example, time, stage, or state).

For each step, the funnel typically shows:

* **Step**: the stage or time
* **Value**: the numeric metric
* **% Max**: value relative to the highest step
* **% Previous**: value relative to the previous step

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fuh6tYsr687LdsEdY1Rz4%2FScreenshot%20from%202026-01-09%2018-24-27.png?alt=media&#x26;token=4cfeedbc-3d65-4566-a3ea-1bdffb86fa0b" alt=""><figcaption><p>Sunburst chart</p></figcaption></figure>

### Configure a funnel chart

Use the **Plot** panel to choose the step column, value column, and sorting.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fc7kJUIEEIwgL5rajtxPU%2FScreenshot%20from%202026-01-09%2018-25-50.png?alt=media&#x26;token=34f33583-e47a-40ce-9c5d-c5a494435d21" alt=""><figcaption></figcaption></figure>

### Funnel chart options

Use these options to control how the funnel chart renders.

| Option             | Purpose                            | Typical values / notes                                                                       |
| ------------------ | ---------------------------------- | -------------------------------------------------------------------------------------------- |
| Step column        | Defines what each step represents. | Common: `timestamp`. Other examples: `stage`, `status`, `pipeline_step`, `deployment_phase`. |
| Step column title  | Display name for the step column.  | Example: `step`. Cosmetic only.                                                              |
| Value column       | Metric to compare across steps.    | Must be numeric. Examples: `value`, `memory_bytes`, `request_count`.                         |
| Value column title | Display name for the value column. | Example: `value`. Cosmetic only.                                                             |
| Enable sorting     | Sort steps before rendering.       | Useful for “top drop-offs” or “largest values first”.                                        |
| Sort column        | Field used for sorting.            | Often the same as Value column (for example `value`).                                        |
| Sort order         | Sorting direction.                 | `Ascending` or `Descending`.                                                                 |
| Apply              | Applies changes to the widget.     | Changes do not render until you click **Apply**.                                             |

{% hint style="info" %}
Key rules: Step column can be time or stage, Value column must be numeric, and sorting controls the funnel order. `% Max` shows relative scale, and `% Previous` shows step-to-step change.
{% endhint %}

### When to use funnel charts

Use funnel charts when you want to:

* track progression
* compare stages
* detect drop-offs
* measure stability