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

# Leads list

> How to use the Leads page in Octanist: the Open, Qualified, Won, Lost, Expired, All and Hidden tabs, filters, sorting, columns, adding leads manually, bulk actions and the 90-day expiry.

The **Leads** page lists every lead in your organization. Here you review new leads and give each one an outcome. Those outcomes are what Octanist sends to your ad platforms, so keeping this list up to date is the most important habit in Octanist.

Open it from **Leads** in the sidebar.

***

## Lead statuses

A lead has one of three statuses: **open**, **won** or **lost**. On top of that, an open lead can be **qualified**, and an open lead expires after 90 days.

| Status | Meaning | What Octanist sends |
| - | - | - |
| **Open** | New lead without an outcome yet. | Nothing yet. |
| **Qualified** | Open lead that is relevant for your business, for example a good prospect that has not bought yet. You can give it an expected value. | The qualified conversion to your connected platforms. |
| **Won** | The lead became a customer. A won lead always has a value above 0. | The won conversion with its value. |
| **Lost** | The lead did not convert. You can record a lost reason. | Lost events go to analytics integrations such as GA4, GTM Server and BigQuery. |
| **Expired** | Open lead that was not won or lost within 90 days of coming in. | Nothing. |

See [Lead details](https://octanist.com/docs/using-octanist/lead-details.md) for how to change a status, and [Qualifying your leads](https://octanist.com/docs/qualifying-leads.md) for why it matters.

> [!NOTE]
>
> Qualified is a milestone, not a final status. A qualified lead stays open until you mark it won or lost. If **Won Lead Auto-Qualification** is on (under [**Settings > Lead Updates**](https://octanist.com/docs/settings/lead-updates.md)), a lead that is won without being qualified first is also marked qualified, and the qualified conversion is sent before the won conversion.

***

## Status tabs

The tabs at the top filter the list:

| Tab | Shows |
| - | - |
| **Open** | Open leads that have not expired, including qualified ones. This is the default. |
| **Qualified** | Open leads that are qualified. |
| **Won** | Won leads. |
| **Lost** | Lost leads. |
| **Expired** | Open leads older than 90 days. |
| **All** | Every lead that is not hidden. |
| **Hidden** | Leads you hid from the list. |

***

## Expired leads

An open lead expires 90 days after it was created. The clock always starts at the original creation date, also for leads that were imported or mapped later.

Expired leads move to the **Expired** tab. Marking a lead won or lost stops the clock.

Why 90 days: ad platforms such as Google Ads only accept offline conversions for a limited time after the click. After that, Octanist can no longer link the conversion to a campaign. Qualify your leads regularly so they do not expire.

To keep an eye on this:

* Show the **Expires In** or **Expires At** column and sort by it.
* Check the **Open leads** card on the [Dashboard](https://octanist.com/docs/using-octanist/dashboard.md#insight-cards). It shows how many leads expire in the next 3 days.
* Turn on the [Lead Expiry Digest](https://octanist.com/docs/using-octanist/email-notifications.md) email.

***

## Working with a lead from the list

Each open lead has quick action buttons in its row:

* **Lost**: mark the lead as lost.
* **Qualified** (star): mark the lead as qualified, with the value in its row.
* **Won**: mark the lead as won. If the lead has no value yet, Octanist first asks for one.

Click a row to open the lead in a side panel with the tabs **Details**, **Journey**, **History** and **Notes**. Use **Open full page** to see the lead on its own page. See [Lead details](https://octanist.com/docs/using-octanist/lead-details.md).

***

## Filters

Click **Filter** to add a condition. Pick a field, a condition and a value. Fields are grouped as:

* **Contact**
* **Attribution**
* **Status & Value**
* **Sent to platforms**
* **Dates**
* **Other**
* **Consent**
* **Custom field**: any field from your forms or API data.

Conditions depend on the field. Text fields support Equals, Not equals and Contains. Numbers support Greater than, Less than and similar. Dates support After, Before, On or after, On or before, and periods such as Last 7 days, This month or This year. Every field supports Is empty and Is not empty.

You can add several filters. They apply on top of the status tab. Filters, the tab, sorting and the page are part of the URL, so you can bookmark or share a filtered view.

> [!TIP]
>
> Click a lead count on the Dashboard to open the leads list with the matching filters already set.

***

## Sorting

Click **Sort** and pick a field, such as Date, Status, Value, Name, Expires In or Qualified At. Pick the same field again to switch between ascending and descending.

***

## Columns

Click **Columns** to open **Edit Columns**. Turn columns on or off and drag them into a new order. Value and Actions are always shown.

Available columns include Status, Date, Added, Name, Email, Phone, External lead ID, Label, Value, Channel, UTM Source, UTM Medium, UTM Campaign, Website, Page Path, Landing Page, Entry Point, Form name, Custom data, Latest Note, Consent (and the separate consent signals), Sent to, Failed to send to, Conversion, Qualified At, Expires At and Expires In.

Click **Custom field** to add a column for one field from your custom data, for example a budget question on your form.

***

## Add a lead manually

Click **Add Lead** to open **Add a lead manually**. Fill in at least one of External lead ID, Name, Email or Phone.

A manual lead has no attribution data and shows as **Manual** in the source column. Use it for leads that reach you outside your website, such as a phone call or a walk-in.

***

## Bulk actions

Select leads with the checkboxes. A bar appears with:

* **Winner**: mark the selected open leads as won. Leads that are not open, or that have no value, are skipped.
* **Loser**: mark the selected open leads as lost. If lost reasons are on, you pick one reason for all of them.
* **Hide** / **Unhide**: move the leads to or from the **Hidden** tab.
* **Delete**: permanently delete the leads and their history. This cannot be undone.

Marking leads won or qualified sends conversions to your connected platforms, just like doing it one by one.

***

## Hiding leads

Hide a lead with **Hide from leads list** on the lead, or with **Hide** in the bulk bar. Hidden leads only show on the **Hidden** tab.

Hiding only cleans up the list. Hidden leads still count in the Dashboard, are still sent to integrations and are still returned by the API. To remove a test lead or a duplicate completely, delete it instead.

***

## Leads hidden by your plan limit

Each plan includes a number of leads per usage period (see [Plans and features](https://octanist.com/docs/using-octanist/plans-and-features.md)). When you go over it, a **Billing Limit Reached** banner shows how many leads are hidden. Upgrade your plan to see them.


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