Moderation

!purge text

Delete recent messages that contain text.

Audience

Staff

Product area

Moderation

Aliases

None

How to use

Supported invocation

!purge text [amount]

amount Optional

The amount for this command.

Access

What the server must allow

  • Discord permission: Manage Messages
  • Availability depends on the server's current service access.
  • The related module must be enabled.
  • Requires Manage Messages.

Expected behavior

Success and unavailable states

When available

The command returns the documented result for !purge text: Delete recent messages that contain text.

When unavailable

  • If !purge text is blocked, Abhi explains the missing staff permission or server setting before any action is applied.
  • No moderation action is applied when hierarchy, target state, or evidence requirements are not satisfied.
  • A temporary failure for !purge text is reported without silently claiming success and can be retried safely.