> For the complete documentation index, see [llms.txt](https://securitybot.gitbook.io/daxeon-knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://securitybot.gitbook.io/daxeon-knowledge-hub/bot-guide/chat-filters/link-filter.md).

# Link Filter

{% hint style="info" %}
**Available on all tiers** — Free tier: 10 filtered actions per day, 20 allowlisted domains. Premium: unlimited. [Compare plans →](/daxeon-knowledge-hub/plans-and-pricing/plans-and-pricing.md)
{% endhint %}

Daxeon's Link Filter deletes any message containing a link to a domain you have not allowed. It stops members posting phishing sites, scam promotions, and links to untrusted content.

***

## How Matching Works

Read this before you build an allowlist, because it decides what your entries actually cover.

Daxeon reduces every posted link to its registrable domain, meaning the last two parts of the host, and compares that against your allowlist.

* Allow `daxeon.bot` and every subdomain comes with it. Links to `docs.daxeon.bot` and `blog.daxeon.bot` are allowed too.
* Allowlisting a subdomain on its own does nothing. An entry for `docs.daxeon.bot` can never match, because Daxeon has already reduced the link to `daxeon.bot` before it compares.

Always enter the two-part domain.

{% hint style="warning" %}
Because allowing a domain allows its subdomains, only allow domains whose subdomains you would also trust. Anyone who can create a subdomain on a name you have allowed can post links your members are free to click.
{% endhint %}

***

## Turn the Filter On or Off

```
/chat_filters domain toggle
```

This flips the filter between states and takes no arguments.

* **Enabled** - any link to a domain outside your allowlist is deleted.
* **Disabled** - members can post links freely, unless another filter catches the message.

{% hint style="warning" %}
Turning the filter on with an empty allowlist deletes every link in your server. Build your allowlist first.
{% endhint %}

The fastest way to start is the **Apply Safe Defaults** button on the link filter step of the [`/setup`](/daxeon-knowledge-hub/command-reference/setup.md) wizard. It allowlists a curated set of trusted domains covering Discord, gif hosts and the sites members share most, then turns the filter on in the same action. Premium servers get the full list, free tier servers get a trimmed version that fits inside the 20-domain cap.

To check the current status and the size of your allowlist:

```
/chat_filters domain about
```

***

## Allow a Trusted Domain

```
/chat_filters domain add domain: <domain>
```

Example:

```
/chat_filters domain add domain: daxeon.bot
```

Members can then share any URL on that domain, such as `https://daxeon.bot/pricing` or `https://daxeon.bot/dashboard`.

You can paste a full URL instead of a bare domain. Daxeon strips the scheme, a leading `www.`, and anything after the host before storing the entry.

***

## Remove a Domain

```
/chat_filters domain remove domain: <domain>
```

Example:

```
/chat_filters domain remove domain: daxeon.bot
```

Links to that domain are blocked again from the next message on, as long as the filter is enabled.

***

## View All Allowed Domains

```
/chat_filters domain view
```

Your domains appear as a paginated list, ten per page.

{% hint style="info" %}
Free tier servers enforce the first 20 entries in the list. If you downgrade from Premium with more than 20 domains allowed, the extra entries are shown struck through and marked as paused. They are kept, not deleted, and they come back if you resubscribe.
{% endhint %}

***

## Best Practices

* Only allow domains you trust and expect your members to use
* Allow the two-part domain, and check that you would trust every subdomain of it
* Add the services your community actually relies on, such as your own site, your docs, and any tools you link to regularly
* Audit your allowlist with `/chat_filters domain view` now and then
* Set a log channel so you can see what the filter is catching

{% hint style="info" %}
Only admins and users with Discord's Administrator permission can manage domain filtering.
{% endhint %}

***

Next up: Catch scams hidden in images with [Image Analysis](/daxeon-knowledge-hub/bot-guide/chat-filters/image-analysis.md).