Skip to main content
Message on mute reacts to a role assignment — specifically, when a moderator gives a user your server’s mute role. This is distinct from Auto mute, which fires automatically on @everyone pings. Open Dashboard → Message on Mute.
How this message is delivered. It posts through a bot-owned webhook. With no custom identity set it uses the bot’s own name and avatar, so it looks exactly like a normal bot message. Enabling Custom identity simply overrides that name and avatar (the custom name is capped at 80 characters — Discord’s webhook limit). This works in both Message and Embed mode. The bot needs Manage Webhooks in the target channel; without it the message is posted normally instead, so nothing is ever lost.

​
How it works

When enabled, the bot watches for members gaining the configured mute role. Each time it sees that assignment, it posts the configured embed to the selected channel, identifying who was muted and which moderator did it.
Resolving who issued the mute ({muted_by} and the muted-by footer icon) requires the View Audit Log permission. Without it, the bot posts the message with the muted-by footer omitted. Servers that invited the bot before this permission was added should grant it to the bot’s role (or re-invite the bot).
The feature does not check why the mute happened — it only reacts to the role change. If you assign the mute role through Discord’s native UI, through /role, or through any other bot, this feature still fires.

​
Settings

​
toggle
Master switch.
​
role picker
The role to watch for. The bot only posts when this specific role is added to a member.
​
WYSIWYG editor
The message posted when the mute is detected, composed in the full message/embed editor (Variables, Markdown, Emoji, Timestamp, Preview, Restore default, Clear). The default template pings the muted user ({user} in the content field) and ships an embed titled You had been MUTED!! with the designed muted-speaker thumbnail, a Muted by footer, and the timestamp enabled. The thumbnail picker offers a Muted Member Avatar quick option to use the muted user’s avatar instead.Everything the old separate toggles did now lives inside the template:
  • Ping the user — put {user} in the message content field.
  • “Muted by” footer — footer text Muted by {muted_by}; the footer icon picker has a Muted-by avatar quick option that shows the moderator’s avatar.
  • Thumbnail — the editor’s thumbnail slot (image library, URL, or an avatar token).
Turn on Custom identity in the editor header to post the mute notice under a custom name and avatar (sent via a webhook). This is Booster or Premium only — the bot also needs the Manage Webhooks permission in the channel; without it, it falls back to posting as the bot.
​
channel picker
Where the notification is posted (below the mute role picker).

​
Available placeholders

  • {user} — ping the muted user
  • {user_name} — muted user’s name as text
  • {muted_by} — moderator who applied the mute
  • {server} — server name
See the placeholders reference for the full list.

​
Interaction with Auto mute

Message on mute and Auto mute are independent features. If both are enabled and Auto mute applies the configured mute role, Message on mute will fire too (and both messages will post). To avoid double-notifications, either:
  • Use a different mute role for Auto mute than the one watched by Message on mute, or
  • Disable Message on mute when Auto mute is active.