> For the complete documentation index, see [llms.txt](https://securitybot.gitbook.io/securitybot-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/securitybot-knowledge-hub/bot-guide/chat-filters/image-analysis.md).

# Image Analysis

{% hint style="warning" %}
**PRO only** — Image Analysis requires a [PRO subscription](/securitybot-knowledge-hub/plans-and-pricing/plans-and-pricing.md). It works alongside the [Link Filter](/securitybot-knowledge-hub/bot-guide/chat-filters/link-filter.md), which must be enabled for images to be acted on.
{% endhint %}

Scammers increasingly hide phishing links and fake giveaways inside images to slip past text-based filters. Image Analysis inspects images posted in your server, reads the domains they point to, and removes those promoting scams to domains you haven't approved.

Image Analysis is **opt-in and disabled by default**. Once you turn it on, it runs automatically in the background with nothing else to configure.

***

### How It Works

When a member posts an image, SecurityBot:

1. Reads the text and any domains shown in the image.
2. Checks those domains against your Link Filter allowlist.
3. For a domain that isn't on your allowlist, reviews the image to decide whether it is promoting a scam.
4. Removes the image only when it is highly confident the image is a scam, and logs the action to your notification channel.

Because Image Analysis builds on your Link Filter, a domain you trust is never flagged. If a legitimate image is ever removed, allowlisting its domain with `/allow_domain` resolves it permanently.

{% hint style="info" %}
Image Analysis only ever **removes** images it is highly confident are scams. When it is unsure, it leaves the image in place, so legitimate posts are not affected.
{% endhint %}

***

### Reviewing and Correcting Decisions

Every action is logged to your notification channel with buttons, so your moderators can review it and help SecurityBot improve.

**When an image is removed**, the alert includes a **Mark false positive** button. Use it if the image was not actually a scam. This is a training signal only:

* It does **not** restore the removed message.
* It does **not** change what gets filtered on its own.

To stop a legitimate domain from being flagged again, allowlist it with the **Allow Domain** button on the same alert (or with `/allow_domain`). Allowlisting is the durable per-server fix; marking a false positive only helps the detector get more accurate over time.

**When SecurityBot is less certain**, it leaves the image in place and posts a warning instead, with two buttons:

* **Confirm scam** removes the image and records the decision.
* **Dismiss** clears the warning and leaves the image untouched.

Only moderators and admins can use these buttons.

***

### Enable Image Analysis

You can turn Image Analysis on from the dashboard or with a slash command.

**From the dashboard**

1. Open your [server dashboard](https://securitybot.org/dashboard) and select your server.
2. Go to **Configure → Image Analysis**.
3. Toggle **Analyze Posted Images** on, then save.

**From Discord**

```
/chat_filters image toggle
```

Run the command to enable Image Analysis for your server. Run it again to turn it back off.

{% hint style="info" %}
Make sure the [Link Filter](/securitybot-knowledge-hub/bot-guide/chat-filters/link-filter.md) is enabled. Image Analysis relies on it to know which domains are untrusted, so it takes no action while link filtering is off.
{% endhint %}

***

### Checking Status

To see whether Image Analysis is currently active:

```
/chat_filters image about
```

***

### Requirements

* **PRO** subscription
* **Link Filter** enabled
* SecurityBot must be able to **manage messages** so it can remove flagged images

***

### What Happens on Downgrade

If your server is downgraded from PRO while Image Analysis is on, it stops taking action automatically. Re-subscribing to PRO restores it, with your toggle preserved.

***

Next up: Learn how to restrict Discord invites with [Discord Invite Filter](/securitybot-knowledge-hub/bot-guide/chat-filters/discord-invite-filter.md).