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

# Message on mute

> Post a configurable embed when a moderator manually applies the mute role to a user.

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](/features/auto-mute), which fires automatically on `@everyone` pings.

Open **Dashboard → Message on Mute**.

<Note>
  **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.
</Note>

## 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.

<Warning>
  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).
</Warning>

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

<ResponseField name="Enable" type="toggle">
  Master switch.
</ResponseField>

<ResponseField name="Mute role" type="role picker">
  The role to watch for. The bot only posts when this specific role is added to a member.
</ResponseField>

<ResponseField name="Message template" type="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.
</ResponseField>

<ResponseField name="Channel" type="channel picker">
  Where the notification is posted (below the mute role picker).
</ResponseField>

## 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](/placeholders) 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.