> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrumpbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bad-avatar detection

> Check new Discord members against a private list of blocked avatars and automatically alert, timeout, kick, or ban matches

Bad-avatar detection checks the display avatar of each new member against a private set of reference avatars chosen by your server managers. It is useful for repeated impersonation, raid branding, and other known images that should be reviewed when a new account joins.

<Info>Bad-avatar detection is included with **Scrump Pro**.</Info>

<Note>Managing the avatar set requires **Manage Server**.</Note>

This is known-image matching, not a general profile classifier. Scrump only compares against the avatars your server has uploaded.

## Configure bad-avatar detection

<Steps>
  <Step title="Open Security">
    Sign in at [scrumpbot.com](https://scrumpbot.com), choose your server, open **Security**, then select **Bad-avatar detection**.
  </Step>

  <Step title="Add reference avatars">
    Give the avatar an internal label, choose a PNG, JPEG, WebP, or GIF image up to 10 MB, and select **Add avatar**.
  </Step>

  <Step title="Choose confidence">
    Use **Exact matches only**, **Very high confidence**, or **High confidence**. Very high confidence is the recommended default.
  </Step>

  <Step title="Choose an action">
    Select **Alert and archive only**, timeout, kick, or ban. Timeout duration can be set from 30 minutes to 30 days and defaults to 1 day.
  </Step>

  <Step title="Customize the member message">
    Preview Scrump's default message or replace it with a custom plain-text or embed version. Scrump sends it only after a timeout, kick, or ban succeeds.
  </Step>
</Steps>

Each server can save up to **100 avatars**. Scrump stores visual matching data, the label, and a small dashboard thumbnail. It discards the original upload after processing.

## Detection records and permissions

Every match appears in the member's moderation history and website moderation archive. Scrump also posts the result to the shared moderation log channel configured in the Security dashboard or with `/settings moderation set-log-channel`.

| Selected action                     | Required bot permission                                     |
| ----------------------------------- | ----------------------------------------------------------- |
| Alert and archive only              | Send Messages and Embed Links in the moderation log channel |
| Timeout for the configured duration | Moderate Members                                            |
| Kick                                | Kick Members                                                |
| Ban                                 | Ban Members                                                 |

For member actions, place Scrump's bot role above the members it may moderate. If the selected punishment cannot be applied, Scrump records an alert-only avatar match rather than claiming that the punishment succeeded.

## Subscription changes

If the server loses Pro, avatar matching and editing stop immediately. Saved avatars and settings remain visible as read-only data. Restoring Pro resumes matching without requiring the reference avatars to be uploaded again.

## Related guides

* [Configure moderation history and logs](/features/moderation)
* [Block unwanted message images](/features/moderation/block-unwanted-images)
* [Review the Security dashboard](/features/moderation/security-dashboard)