> ## 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.

# Custom dashboards

> How to build custom dashboards in Octanist: create a dashboard, add charts with the chart editor (data, metric, breakdown, split by, comparison, filters), save charts from the AI assistant, and which plan you need.

Custom dashboards let you put the charts your team checks every week on one tab. Each dashboard shows up as a tab on the [Dashboard](https://octanist.com/docs/using-octanist/dashboard.md) page, next to **Performance**.

> [!NOTE]
>
> Custom dashboards are in beta and need the **Professional** plan or higher. On a lower plan, the **Custom** tab shows an upgrade notice.

Custom dashboards belong to your organization. Everyone in the organization sees the same dashboards and can change them.

***

## Create a dashboard

1. Open **Dashboard**.
2. Click **+** after the tabs (it says **Custom** when you have no custom dashboards yet).
3. Enter a name, for example "Weekly review", and click **Create**.

The new dashboard opens as a tab. An organization can have up to 50 custom dashboards.

To rename or delete a dashboard, open its tab and use the options menu (**...**): **Rename** or **Delete dashboard**. Deleting removes the dashboard and its charts for everyone. Your data is not affected.

***

## Date range and comparison

Charts on a custom dashboard follow the date range in the Dashboard header. So leave the period out of a chart's title.

When you turn on **Compare to previous period** in the date picker, every chart compares with the previous period.

The All / Paid and channel filters of the other tabs do not apply here. Each chart has its own filters instead.

***

## Add a chart

Click **Add chart**. A dashboard can hold up to 24 charts.

The chart editor has these fields:

### Title

Optional. If you leave it empty, Octanist makes a title from the metric and breakdown.

### Data

What the chart is about:

| Data | Contains |
| - | - |
| **Leads & ad spend** | Lead counts, values, costs and rates, like the Performance tab. |
| **Website traffic** | Sessions, visitors, page views and leads from visits. Needs the [tracking pixel](https://octanist.com/docs/incoming-integrations/pixel.md). |
| **Ad platforms** | Numbers as your ad platforms report them: spend, clicks, impressions, CTR, CPC and platform conversions. |
| **Calls** | Calls, answered and missed calls, call duration and calls that became leads. Only shown when [call tracking](https://octanist.com/docs/incoming-integrations/call-tracking.md) is on. |

### Metric and Second metric

Pick the main **Metric**. Optionally pick a **Second metric** to show next to it.

Metrics per data source:

* **Leads & ad spend**: Total Leads, Open Leads, Qualified Leads, Won Leads, Lost Leads, Value Won, Value Lost, Average Lead Value, Ad spend, Extra costs, Total cost, Cost Per Lead, Cost Per Qualified Lead, Cost Per Won Lead, Cost per Click, Qualification Rate, Qualified Win Rate, Won Rate, Click-Through Rate, Clicks, Impressions, Return on Ad Spend, Won to Lost Ratio.
* **Website traffic**: Sessions, Visitors, Page views, Leads from visits, Qualified from visits, Won from visits, Revenue from visits, Conversion rate, Revenue per session.
* **Ad platforms**: Ad spend, Clicks, Impressions, Click-through rate, Cost per click, Platform conversions, Cost per platform conversion.
* **Calls**: Calls, Answered calls, Missed calls, Missed call rate, Average call duration, Calls that became leads, Call to lead rate.

> [!NOTE]
>
> **Platform conversions** are the conversions your ad platforms report themselves. They are not Octanist leads.

### Break down by

How the chart groups its data. **No breakdown (totals)** shows one number. **Over time** shows how the metric develops over the date range.

Other breakdowns depend on the data source:

* **Leads & ad spend**: Channel, Source (attributed), Medium (attributed), Campaign (UTM), Source / medium, Source / medium / campaign, Ad campaign (with spend), Lead status, Label, Form, Visit country, Device, Browser, Operating system, Website, Landing page, Referrer, UTM source, UTM medium, UTM campaign, Phone country, Lost reason, Custom field, Day of the week, Hour of the day, Day and hour.
* **Website traffic**: Channel, Referrer, Landing page, Page, UTM source, UTM medium, UTM campaign, Website, Device, Country, Browser.
* **Ad platforms**: Ad platform, Ad account, Campaign, Ad group.
* **Calls**: Call status, Channel, UTM source, UTM campaign, Landing page, Day of the week, Hour of the day, Day and hour.

**Ad campaign (with spend)** groups leads by the ad platform campaign, with that campaign's spend. Use it for cost per lead per campaign. **Campaign (UTM)** groups by the `utm_campaign` value instead and has no spend.

For **Custom field**, enter the **Custom field key**, for example `budget`.

### Split by

Only for **Over time**. Draws one line per value, for example leads over time with one line per channel. The six biggest values get their own line and the rest are combined as "Other". Choose **One line (total)** for a single line.

Website traffic charts cannot be split yet. Split charts do not compare periods.

### Comparison

Pick **No comparison**, **Compare with previous period**, **Compare with same days last month** or **Compare with same period last year**.

### Show as

* **Number cards**
* **Line chart**
* **Bar chart**
* **Table**
* **Funnel**
* **Heatmap (day and hour)**: for the Day and hour breakdown.
* **World map**: for country breakdowns.

Octanist only offers the types that fit your metric and breakdown.

### Only leads where

For **Leads & ad spend** charts, click **Add condition** to limit the chart to certain leads. Pick a field (such as Email, Phone, Phone country, Name, Note, Visit country, Device, Browser, Operating system, Website, Landing page, Referrer or a UTM field), a condition (**is**, **is not**, **contains**, **is filled in** or **is empty**) and values. Separate several values with commas, for example `NL, BE`.

If a combination is not possible, the editor tells you to check the metric, breakdown and filters.

***

## Arrange charts

Use a chart's options menu (**...**) to:

* **Edit** the chart.
* **Make full width** or **Make half width**.
* **Move earlier** or **Move later**.
* **Remove** the chart.

***

## Save charts from the AI assistant

The [AI assistant](https://octanist.com/docs/using-octanist/ai-assistant.md) can answer with a chart. Click **Add to dashboard** under the chart, then pick a dashboard or create a new one. Charts made by the assistant are marked with a sparkle icon.

An empty dashboard also has an **Ask the assistant** button.


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