Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

Funnel docs

Blue Mouse889a694fa0ad
diff --git a/docs/docs/analytics-dashboard/funnels.md b/docs/docs/analytics-dashboard/funnels.md
new file mode 100644
index 000000000..bba844c3a
--- /dev/null
+++ b/docs/docs/analytics-dashboard/funnels.md
@@ -0,0 +1,64 @@
+---
+id: funnels
+title: Funnels
+sidebar_label: Funnels
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+Funnels allow you to visualise and measure how many users complete a specific series of steps on your website. This is essential for understanding conversion rates and identifying where users drop off in key processes like sign-ups, checkouts, or onboarding flows.
+
+<img alt="Funnel view" src={useBaseUrl('img/analytics-dashboard/funnel-view.png')} />
+
+## Overview
+
+A funnel consists of a sequence of steps (pageviews or custom events) that you expect users to follow. Swetrix tracks the number of unique visitors who complete each step and calculates the conversion rate between them.
+
+The Funnels dashboard provides a list of all your active funnels. Clicking on a funnel opens detailed analytics for that specific flow.
+
+## Creating a Funnel
+
+To create a new funnel:
+
+1. Navigate to the **Funnels** tab in your project dashboard.
+2. Click the **New Funnel** button (or the large card with a plus icon).
+3. **Name**: Give your funnel a descriptive name (e.g., "Checkout Flow").
+4. **Steps**: Add the steps you want to track in order.
+ - A step can be a **Page Path** (e.g., `/pricing`) or a **Custom Event** name (e.g., `signup_button_clicked`).
+ - You can add multiple steps to define the exact journey.
+5. Click **Create funnel** to save.
+
+<img alt="Create a funnel" src={useBaseUrl('img/analytics-dashboard/create-funnel.png')} />
+
+## Analyzing a Funnel
+
+When you view a specific funnel, you'll see a visualization of the user journey along with key performance metrics.
+
+### Summary Metrics
+
+At the top of the funnel view, you will find a summary:
+
+- **Steps**: The total number of steps in the funnel.
+- **Conversion Rate**: The percentage of users who started the funnel and successfully reached the final step.
+- **Start Visitors**: The number of unique visitors who entered the funnel (completed the first step).
+- **End Visitors**: The number of unique visitors who completed the entire funnel.
+
+### Funnel Chart
+
+The chart visualizes the flow of users through each step:
+
+- **Visitors**: The green bar shows the number of users who successfully reached this step.
+- **Dropoff**: The red bar indicates the number of users who left the funnel at this step (did not proceed to the next one).
+
+This visualization helps you instantly spot the "leaky" parts of your flow where you are losing the most users.
+
+## Managing Funnels
+
+You can manage your funnels directly from the main list:
+
+- **Edit**: Click the **Settings** (gear) icon on a funnel card to change its name or modify the steps.
+- **Delete**: Click the **Delete** (trash bin) icon to remove the funnel permanently.
+
+:::info Permissions
+Only project owners and administrators (managers) can create, edit, or delete funnels. View-only members can view the funnel data but cannot make changes.
+:::
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 7312c3fb1..e4741a69f 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -28,6 +28,7 @@ module.exports = {
'analytics-dashboard/ask-ai',
'analytics-dashboard/traffic',
'analytics-dashboard/performance',
+ 'analytics-dashboard/funnels',
'analytics-dashboard/alerts',
'analytics-dashboard/profiles-and-sessions',
'analytics-dashboard/feature-flags',
diff --git a/docs/static/img/analytics-dashboard/create-funnel.png b/docs/static/img/analytics-dashboard/create-funnel.png
new file mode 100644
index 000000000..beb9bf616
Binary files /dev/null and b/docs/static/img/analytics-dashboard/create-funnel.png differ
diff --git a/docs/static/img/analytics-dashboard/funnel-view.png b/docs/static/img/analytics-dashboard/funnel-view.png
new file mode 100644
index 000000000..ffb57ff2a
Binary files /dev/null and b/docs/static/img/analytics-dashboard/funnel-view.png differ