:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import type { ReactElement } from 'react'
import { emptyStateIllustration } from '@posthog/mcp-ui'
import { Empty, EmptyDescription, EmptyHeader, EmptyMedia } from '@posthog/quill'
import { BarChart, TooltipSurface, type TooltipContext } from '@posthog/quill-charts'
import {
buildFunnelStepsBarConfig,
buildSingleSeriesFunnelStepsBars,
type FunnelStepsBarRow,
} from 'products/product_analytics/frontend/insights/funnels/shared/funnelStepsBarShared'
import { ChartHeader } from './ChartHeader'
import { FUNNEL_COLOR, useMcpChartTheme } from './charts/theme'
import type { FunnelVisualizerProps } from './types'
import { formatNumber, formatPercent, normalizeFunnelSteps } from './utils'
const TITLE = 'Funnel'
const NOOP = (): void => {}
// The web container hides the x-axis and renders its own StepNameLabel row; this compact UI app instead
// shows the step names on the axis (truncated) and tracks the cursor with the tooltip.
const CHART_CONFIG = buildFunnelStepsBarConfig({ maxCategoryLabelWidth: 120, tooltipPlacement: 'cursor' })
function renderTooltip(rows: FunnelStepsBarRow[]) {
return function FunnelTooltip(ctx: TooltipContext): ReactElement | null {
const row = rows[ctx.dataIndex]
if (!row) {
return null
}
return (
<TooltipSurface>
<div className="font-semibold mb-1">
{row.stepIndex + 1}. {row.name}
</div>
<div>
{formatNumber(row.count)} ({formatPercent(row.fractionOfBasis)} of first step)
</div>
{row.stepIndex > 0 && <div>{formatPercent(row.fromPrevious)} from previous step</div>}
</TooltipSurface>
)
}
}
export function FunnelVisualizer({ results }: FunnelVisualizerProps): ReactElement {
const theme = useMcpChartTheme()
const steps = normalizeFunnelSteps(results)
const { series, labels, rows, overall } = buildSingleSeriesFunnelStepsBars(steps, { color: FUNNEL_COLOR })
// Labels are 1-based step indices (the shared builder keys the band by index so duplicate step names
// don't collapse onto one slot); map each tick back to its step name for the compact axis.
const config: typeof CHART_CONFIG = {
...CHART_CONFIG,
xTickFormatter: (_value, index) => rows[index]?.name ?? '',
}
if (steps.length === 0) {
return (
<div>
<ChartHeader title={TITLE} />
<Empty>
<EmptyHeader>
<EmptyMedia>{emptyStateIllustration('funnel')}</EmptyMedia>
<EmptyDescription>No funnel data available</EmptyDescription>
</EmptyHeader>
</Empty>
</div>
)
}
return (
<div data-attr="funnel-steps-bar" className="w-full">
<ChartHeader title={TITLE} />
<div className="flex flex-col h-72 w-full">
<BarChart
series={series}
labels={labels}
theme={theme}
config={config}
tooltip={renderTooltip(rows)}
onError={NOOP}
/>
</div>
{steps.length >= 2 && (
<div className="mt-4 rounded-md bg-muted/50 p-3 text-sm text-muted-foreground">
<strong className="text-foreground">Overall conversion:</strong> {formatPercent(overall.rate)} (
{formatNumber(overall.lastCount)} of {formatNumber(overall.firstCount)})
</div>
)}
</div>
)
}