Discord error 20009: Explicit content cannot be sent
Last verified against Discord Developer Docs - Opcodes and status codes
Explicit content cannot be sent to the desired recipient(s)What error 20009 means
Discord's explicit media filtering decided that something in the message, usually an image or video attachment, counts as explicit content, and the recipient's safety settings do not allow it. The message is rejected rather than delivered with a blur.
This is a safety-filter decision, not a permissions problem and not an AutoMod rule. AutoMod blocks come back as 200000. With 20009 the server's moderators did not configure anything; Discord applied its own filter based on the recipient or channel settings.
Discord does not publish how its classifier decides. Do not try to work around it by re-encoding or cropping images. If your bot legitimately handles mature content, it belongs in channels marked age-restricted, and you should accept that some DM recipients will not receive it.
What it looks like
{
"message": "Explicit content cannot be sent to the desired recipient(s)",
"code": 20009
}Why it happens
- Bot sent an attachment the filter classified as explicit to a DM recipient whose settings block it
- Image-relay or meme bot forwarded user-supplied media without checking it
- Channel or recipient settings stricter than the bot author assumed
How to fix Discord error 20009
- 1Log which attachment triggered 20009 and stop retrying that payload
- 2Send mature content only to age-restricted channels where that is appropriate
- 3Tell the requesting user the media could not be delivered instead of failing silently
- 4Review any feature that relays user-uploaded media to other users
- 5Record the channel or recipient alongside the failure so repeated blocks can be traced to specific settings
How to stop it recurring
If your bot relays media between users, treat delivery as best-effort and surface 20009 to the sender. Keep mature features confined to age-restricted channels, and do not design flows that DM media to people who did not ask for it.
Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.
Related codes
- 200000: Message was blocked by automatic moderationMessage was blocked by automatic moderation
- 240000: Message blocked by harmful links filterMessage blocked by harmful links filter
- 50007: Cannot send messages to this userCannot send messages to this user
- 160010: NSFW channel message reference not allowedNSFW channel message reference not allowed
Error 20009 - quick answers
What does Discord error 20009 mean?
Discord's explicit media filtering decided that something in the message, usually an image or video attachment, counts as explicit content, and the recipient's safety settings do not allow it. The message is rejected rather than delivered with a blur. This is a safety-filter decision, not a permissions problem and not an AutoMod rule. AutoMod blocks come back as 200000 .
How do I fix Discord error 20009?
1. Log which attachment triggered 20009 and stop retrying that payload 2. Send mature content only to age-restricted channels where that is appropriate 3. Tell the requesting user the media could not be delivered instead of failing silently 4. Review any feature that relays user-uploaded media to other users 5. Record the channel or recipient alongside the failure so repeated blocks can be traced to specific settings
Stop debugging Discord by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.