> ## 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.
# How to Block Unwanted Images on Discord
> Use a Discord image filter bot to block exact or edited copies of unwanted images, then delete, timeout, kick, or ban and send private moderation logs.
Scrump can automatically block unwanted images on Discord by comparing new image attachments with a private list created by your server managers. Upload a banned image, meme, spam picture, or other disallowed visual once, then choose whether matching posts are deleted or also trigger a timeout, kick, or ban.
Block Unwanted Images is included with **Scrump Pro**.
Managing the Discord image blocklist requires **Manage Server**.
This feature is a custom known-image filter. It detects exact and visually similar copies of images that an administrator has uploaded. It is not a general NSFW classifier and does not block every image based on its subject.
## How to block an image on Discord
Sign in at [scrumpbot.com](https://scrumpbot.com), choose the Discord server, and select **Security**.
Open the **Block Unwanted Images** section, enter a short internal label, and select the reference image you want to ban.
Select **Add image**. Scrump validates the upload, creates its matching data, and adds it to the server's private image filter.
Start with **Very high confidence** and adjust only if you need exact matching or broader edited-image detection.
Choose **Delete message**, **Delete + timeout**, **Delete + kick**, or **Delete + ban**. Timeout duration can be set from 30 minutes to 30 days and defaults to 1 day. You can also select a private image log channel and customize the default member message as plain text or an embed.
Supported blocklist uploads are PNG, JPEG, WebP, and GIF files up to 10 MB. For animated GIFs, Scrump uses the first frame. Each server can keep up to **250 blocked images**.
Scrump keeps the administrator-provided label and a small management thumbnail. The original blocklist upload is discarded after processing.
## Discord image filter sensitivity
| Setting | Use when |
| ------------------------ | ---------------------------------------------------------------------- |
| **Exact matches only** | Only an identical copy of the banned image should be deleted. |
| **Very high confidence** | Small common edits should still match. This is the default. |
| **High confidence** | You need broader near-duplicate matching and will monitor the results. |
Higher sensitivity can catch more resized, recompressed, or lightly edited versions of a blocked image, but broader matching should be monitored for unwanted detections.
## What happens when Scrump detects a blocked image
Scrump checks image attachments posted in the Discord server. When an attachment matches the server's private image blocklist, Scrump:
1. Attempts to delete the Discord message and apply the configured member action.
2. Writes the completed action to the moderation archive.
3. Sends an optional private log containing the sender, channel, matched entry, action, and detected image.
4. Sends the default plain-text DM, or the server's custom plain-text or embed version, after a deletion or punishment succeeds.
5. Counts the event separately from scam-image detections.
| Selected action | What Scrump attempts | Required bot permissions |
| -------------------- | --------------------------------------------------------------------- | ------------------------------------ |
| **Delete message** | Delete the matching Discord message | Manage Messages |
| **Delete + timeout** | Delete the message and timeout the member for the configured duration | Manage Messages and Moderate Members |
| **Delete + kick** | Delete the message and kick the member | Manage Messages and Kick Members |
| **Delete + ban** | Delete the message and ban the member | Manage Messages and Ban Members |
Scrump must be able to view the channel and inspect the attachment. For timeout, kick, or ban actions, place the Scrump bot role above the members it may moderate. If a selected punishment fails but message deletion succeeds, the moderation archive records the deletion that actually happened.
The optional image log channel requires **View Channel**, **Send Messages**, **Embed Links**, and **Attach Files**. Images larger than 10 MB and unsupported files are not checked by this feature.
Scrump checks up to the first 10 image attachments in a message. It does not inspect videos, image URLs pasted as text, or remote images shown only through an embed.
## Remove an image or downgrade the server
Server managers can delete blocklist entries from the Security dashboard.
If the server downgrades below Pro, enforcement and editing stop. The private list remains stored and appears read-only, so upgrading to Pro restores it without requiring another upload.
## Discord image blocking troubleshooting
If an unwanted image is not being deleted, check that:
* The server has an active Pro plan and the feature is available for the server.
* The reference image still appears in the Security dashboard blocklist.
* Scrump has the permissions required for the selected delete, timeout, kick, or ban action.
* The Scrump bot role is above the member when a timeout, kick, or ban is selected.
* Scrump can send messages, embeds, and files in the optional image log channel.
* The posted attachment is a supported image no larger than 10 MB.
* The edited image is similar enough for the selected sensitivity.
* The image quality is high enough for reliable visual matching.
## Discord image filter FAQ
### How do I block a specific image on Discord?
Open the Scrump Security dashboard, add the reference image to **Block Unwanted Images**, choose a sensitivity, and select the response. Scrump can delete matching Discord attachments or combine deletion with a timeout, kick, or ban.
### Can a Discord bot automatically delete banned memes or spam images?
Yes. Add each known meme, spam image, or other banned picture to the server's private blocklist. Scrump checks future attachments and removes matching copies.
### Can the Discord image filter timeout, kick, or ban a sender?
Yes. Server managers can choose delete only, a timeout from 30 minutes to 30 days, kick, or ban. Scrump needs the corresponding Discord permission and a role high enough to moderate the member.
### Does Scrump block every NSFW image or every image in a channel?
No. Block Unwanted Images matches against administrator-uploaded reference images. It is not a semantic content filter, NSFW classifier, or setting that disables all image uploads.
### Can Scrump block an image URL or a video?
No. This feature checks Discord image attachments. It does not filter pasted URLs, remote embed images, or video files.
### Can the Discord image filter detect resized or edited copies?
The **Very high confidence** and **High confidence** settings can match some visually similar copies, including common resizing or compression changes. Detection depends on how much the image has changed.
### Is Block Unwanted Images the same as scam-image protection?
No. The custom blocklist is for server-specific unwanted images. Scrump's separate [scam-image protection](/features/moderation/block-scams) detects known scam campaigns and can alert, mute, kick, or ban according to your automod settings.
### Does Scrump store the original blocked image?
Scrump discards the original administrator upload after processing. It retains matching data, the label, and a small management thumbnail for the private dashboard.
## Related Discord guides
* [Block scam images and fake giveaways](/features/moderation/block-scams)
* [Configure Discord AutoMod](/features/automation/automod)
* [Review the Discord security dashboard](/features/moderation/security-dashboard)