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

# Lead filtering

> Accept or reject incoming leads based on the website they come from, with allowed and blocked domains, and how Octanist handles bot traffic.

Lead filtering decides which leads Octanist accepts, based on the website where the lead came in. Use it to keep out leads from staging sites, test environments, copies of your site, or domains that send spam.

Go to **Settings > Lead Filtering** and turn on the switch. The lists only apply while filtering is **Enabled**.

## Two modes

| Mode | When it applies | Effect |
| - | - | - |
| Allowed Domains | At least one allowed domain is added. | Only leads from these domains are accepted. All other leads are rejected. |
| Blocked Domains | The allowed list is empty and at least one blocked domain is added. | Leads from these domains are rejected. All other leads are accepted. |

You use one mode at a time. The **Blocked Domains** card is only shown while the allowed list is empty. Adding a domain to one list removes it from the other.

> [!WARNING]
>
> With allowed domains, leads without a known website are rejected too, for example leads sent through the API without a session or website.

## Add a domain

1. Enter the domain in **Add allowed domain** or **Add blocked domain**, such as `example.com`.
2. Click **Add** or press Enter.

Octanist removes `https://`, `www.` and any path, so `https://www.example.com/contact` becomes `example.com`. Click the **x** on a domain to remove it.

## Domain matching

A domain also matches its subdomains, but not other domains that end with the same letters.

| You add | Matches | Doesn't match |
| - | - | - |
| `example.com` | `example.com`, `www.example.com`, `shop.example.com` | `notexample.com`, `myexample.com` |

## Which leads are checked

The domain comes from the website session the lead is linked to. Leads from Meta Lead Ads, TikTok Lead Forms and Snapchat Lead Forms are not filtered, because they don't come from your website.

## Typical setups

| Goal | Setup |
| - | - |
| Only count leads from your live website | Add your domain, such as `example.com`, to **Allowed Domains**. |
| Count leads from several websites | Add each domain to **Allowed Domains**. |
| Keep one test or staging site out | Leave **Allowed Domains** empty and add that domain to **Blocked Domains**. |

## Bot traffic

Octanist filters known bots and automated browsers automatically, on every plan. You don't need to set anything for this.

## Other ways to keep leads clean

* [Ignore forms](https://octanist.com/docs/incoming-integrations/form-mapping.md#ignore-a-form) that should never create leads, such as search or login forms.
* Use the [Tracking health](https://octanist.com/docs/settings/tracking-health.md) tab to spot pages and forms that don't come through.


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