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

# Dashboard

> How the Octanist Dashboard and its Performance tab work: date ranges, comparison, filters, every KPI and chart, and how leads and ad spend are attributed.

The **Dashboard** shows how your leads, their outcomes and your ad spend relate. Open it from **Dashboard** in the sidebar.

The Dashboard has these tabs:

| Tab | What it shows | Needs |
| - | - | - |
| **Performance** | Leads, qualified and won leads, won value, spend, cost per lead and ROAS per channel, source or campaign. | Leads in Octanist. Ad spend needs a connected ad platform. |
| [**Acquisition**](https://octanist.com/docs/using-octanist/acquisition-and-journeys.md) | Website visits, sources, pages, countries and devices, and how they turn into leads. | The [tracking pixel](https://octanist.com/docs/incoming-integrations/pixel.md). |
| [**Journeys**](https://octanist.com/docs/using-octanist/acquisition-and-journeys.md#journeys-tab) | The visits a lead made before it converted. | The [tracking pixel](https://octanist.com/docs/incoming-integrations/pixel.md). |
| [**Custom dashboards**](https://octanist.com/docs/using-octanist/custom-dashboards.md) | Your own dashboards, each as its own tab. | Professional plan or higher. |

There is also a separate [Google Ads dashboard](https://octanist.com/docs/using-octanist/google-ads-dashboard.md) with campaign and ad group numbers.

> [!TIP]
>
> Click the info icon next to the **Dashboard** title ("How is this calculated?") for a short summary of the methodology in the app.

***

## The header controls

The row at the top of the Dashboard applies to the tab you are on.

### Date range

Click the date range to pick a period. The default is **Last 90 days**. You can choose:

* Today, Yesterday
* Last 7 days, Last 14 days, Last 30 days, Last 90 days, Last 180 days, Last 365 days
* This week, Last week, This month, Last month
* This quarter, Last quarter, This year, Last year
* **Custom range**

All dates use your organization's time zone. Leads and spend are put on the day they happened in that time zone.

### Compare to previous period

Tick **Compare to previous period** in the date picker. Octanist then compares every KPI with the period of the same length just before it. Each KPI shows the change, and the trend chart draws the previous period as an extra line.

Use this to answer "are we doing better than last month?" without switching ranges back and forth.

### All / Paid and the channel filter

* **All** includes every lead, also organic, direct and manual leads.
* **Paid** limits the tab to ad platform channels and "Other Paid Traffic".
* The channel filter lets you pick channels one by one, such as "Google Ads", "Meta Ads", "Organic / Direct", "Other Paid Traffic" or "Manual".

### Breakdown (Performance tab only)

The breakdown menu sets how the Performance table and charts are grouped:

* By Channel
* By Source
* By Medium
* By Source / Medium
* By Source / Medium / Campaign
* By Campaign
* By Organization (only in portfolio view)

### Filter

Click **Filter** to limit the tab to certain leads. You can filter on:

* **Label**
* **Form name**
* **Lead status** (Open, Qualified, Won, Lost)
* **Custom data (any field)** or a specific **Custom field**, with conditions such as Is, Is not, Contains, Has a value and Is empty

On the Acquisition tab you can also filter on visit details.

> [!WARNING]
>
> Form and custom field filters apply to leads only. Ad spend cannot be linked to a form or a custom field, so spend, CPL and ROAS still include all campaigns in the date range. The Dashboard shows a warning when this applies.

### Portfolio view

If your organization has child organizations (for example an agency with client accounts), a **Single** / **Portfolio** switch appears. **Portfolio** combines the numbers of the organizations you pick under **Organizations**. In portfolio view you can also break down **By Organization**.

***

## Performance tab

The Performance tab reads from top to bottom: what came in, what it cost, and what it returned.

### KPI row

| KPI | Meaning |
| - | - |
| **Total** | Leads created in the period. |
| **Qualified** | Leads from the period that were marked as qualified, with their share of all leads. |
| **Won** | Leads from the period that were marked as won, with their share of all leads. |
| **Won Value** | The total value of the won leads. |
| **Ad spend** | Spend synced from your ad platforms. Shows **Total cost** instead when you have extra costs. |
| **CPL** | Cost per lead: cost divided by leads. |
| **CPQL** | Cost per qualified lead. |
| **ROAS** | Return on ad spend: won value divided by cost. |

Each KPI shows the change against the comparison period (when comparison is on) and a small trend line. Click a lead count to open the [leads list](https://octanist.com/docs/using-octanist/leads.md) with those leads.

> [!NOTE]
>
> Without a channel filter, ROAS is shown as **ROI\***. It then includes revenue from all sources, also organic and manual leads. Filter to paid sources to see ad-only ROAS.

### Performance table

The table is titled "Performance by" your breakdown, for example **Performance by channel**. Click a column header to sort.

Use **View** to choose which metric columns are visible. **Edit & reorder** lets you drag columns in a new order, and **Reset default view** brings back the standard columns.

The Google Ads row links to the [Google Ads dashboard](https://octanist.com/docs/using-octanist/google-ads-dashboard.md).

### Charts

* **Trends over time**: one metric over the period. Pick Day, Week, Month, Quarter or Year, and Bars, Line or Area.
* **Multi-metric comparison**: several metrics in one chart. **Indexed** puts them on the same scale so you can compare their shape; **Actual** shows the real values.
* A chart per breakdown value over time, for example one line per channel.
* A chart that compares breakdown values, as bars or a pie.
* **Outcomes**: switch between **Won / Lost Ratio**, **Value Breakdown** (value won versus value lost) and **ROAS Overview** (cost versus revenue).
* **Conversion funnel**: Leads → Qualified → Won, with the conversion rate between each step.

### Insight cards

* **Open leads**: leads from this period that still wait for an outcome, grouped by age (up to 7 days, 8–14, 15–30, 31–60, 61–90 days, and older than 90 days, which are expired). It also shows how many expire in the next 3 days.
* **Lead quality by channel** (or by your breakdown): the share of leads that were qualified and won. A row needs at least 10 leads to show rates.
* **Why leads were lost**: lost leads from this period by the [lost reason](https://octanist.com/docs/using-octanist/lead-details.md#marking-a-lead-as-lost) given.
* **When leads come in**: leads per weekday and hour, in your organization's time zone.

***

## How the numbers are calculated

### Leads count on the day they came in

Lead metrics are cohort-based. A lead counts on the day it was created, also when it was won later. A lead from 15 January that is won on 10 February counts as won on 15 January.

This answers "how are the leads from January doing?" rather than "what happened in January?". It shows directly what your ad spend brought in.

This also means the numbers for a recent period can still grow, as more of its leads are qualified and won.

### Ad spend and extra costs

**Ad spend** is only what Octanist syncs from your ad platforms, on the day it was spent.

You can add extra costs (such as invoices, agency fees, tools and retainers) under [**Settings > Extra costs**](https://octanist.com/docs/settings/ad-spend-and-extra-costs.md). Octanist spreads them over each day in the range. Once you have extra costs:

* **Total cost** is Ad spend plus Extra costs.
* CPL, CPQL, CPWL and ROAS use Total cost.
* CPC always uses Ad spend.

### Channels

Octanist puts each lead in a channel in this order:

1. **Click IDs**, the most reliable signal. For example `gclid` means Google, `fbp`/`fbc` means Meta and `msclkid` means Microsoft. Click IDs always win over UTMs.
2. **Paid UTMs**. When the medium is paid (such as `cpc`, `ppc` or `paid_social`), Octanist matches `utm_source` to a known ad platform.
3. **Other Paid Traffic**. A paid medium with an empty source, or with a source that is not an ad platform (for example a marketplace with `cpc`).
4. **Organic / Direct**. An organic medium, a direct visit, or no paid parameters.

### Attribution model

How a lead is credited to channels depends on the attribution model under [**Settings > Attribution**](https://octanist.com/docs/settings/attribution.md):

| Model | Credit |
| - | - |
| All Channels (Touch-Based) (default) | Every distinct channel in the journey gets full credit. |
| Last Click | 100% to the channel of the session where the lead converted. |
| First Click | 100% to the channel that started the journey. |
| Linear | Split equally across all channels in the journey. |
| Position-Based | 40% to the first and last channel, 20% split across the middle. |
| Time Decay | More credit to channels closer to the conversion. |

With **All Channels**, a lead that touched both Google and Meta appears in both rows. Channel rows then do not add up to the total, but the total row counts each lead once. The other models split credit, so channel rows add up to the total.

### Expired leads

Open leads expire 90 days after they were created. See [Expired leads](https://octanist.com/docs/using-octanist/leads.md#expired-leads).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.