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

# Delete user messages

> Bulk-delete recent messages from a specific user across every channel.

Delete user messages scans every channel the bot can see and deletes recent messages from a single target user. Useful for cleaning up after a raid, a spam incident, or when a former member asks for their content to be removed.

Open **Dashboard → Delete User Messages**.

## Running a cleanup

<Steps>
  <Step title="Enter the target user ID">
    Paste the Discord user ID of the member whose messages you want to delete. Right-click the member in Discord and choose **Copy User ID** (Developer Mode must be enabled in your Discord settings).
  </Step>

  <Step title="Pick retrieve and delete counts">
    **Retrieve count** — how many recent messages per channel the bot scans. Options: 20, 50, 100.
    **Delete count** — maximum messages to delete per channel. Options: 1 through 20.
  </Step>

  <Step title="Click Start Cleanup">
    The bot walks every accessible channel, collects matches, and deletes them. Progress is shown under the button, and a per-channel result log is printed below.
  </Step>
</Steps>

You can also trigger a cleanup from Discord with `/user_clean_messages @user`.

<Note>
  Works even if the target has **already left the server**. Pick them from the user
  picker (or paste their ID) and the bot will still delete their leftover messages —
  it just needs **Manage Messages** in each channel.
</Note>

## Settings

<ResponseField name="Enable" type="toggle">
  Master switch. If off, `/user_clean_messages` is disabled and the dashboard cleanup button is hidden.
</ResponseField>

<ResponseField name="Allowed roles" type="role list">
  Only members with at least one of these roles can run `/user_clean_messages`. Leave empty to allow everyone. Guild owners and Admins are always immune.
</ResponseField>

<ResponseField name="Blacklisted roles" type="role list">
  Members with any of these roles are always blocked from running the command, even if they also have an allowed role. Guild owners and Admins are always immune.
</ResponseField>

## What gets deleted

* Messages from the target user only. Other users' messages, including replies to the target, are kept.
* Up to the configured delete count per channel. If a channel has 30 matching messages and delete count is 5, only the 5 most recent are removed.
* Messages the bot has permission to delete. Channels where the bot lacks **Manage Messages** are skipped and reported in the log.

<Warning>
  Deletion is irreversible. Double-check the user ID before clicking **Start Cleanup** — there is no dry-run mode.
</Warning>