Skip to content
Moderation removeReaction

$removeReaction

The $removeReaction[] function allows removing all reactions of a specific emoji from a message.

Syntax

$removeReaction[channelID;messageID;userID;emoji]

The function requires exactly 4 arguments.

Parameters

Parameter Description
channelID The ID of the channel containing the message.
messageID The ID of the target message.
userID Required argument, but its value is not read by the engine (it does not restrict the removal to this user).
emoji The emoji to remove (Unicode, custom <:name:ID> or a numeric custom emoji ID).

Return Value

This function does not return a value.

Behavior

  • Removes every reaction using this emoji from the message (all users, not only the bot’s).
  • The bot needs the Manage Messages permission in the channel (error Missing channel permissions for reactions. otherwise).
  • An empty emoji raises the error “An emoji is required.”.

Examples

Progress indicator

$addCmdReactions[⏳]
$wait[3]
$removeReaction[$channelID;$messageID;$authorID;⏳]
$addCmdReactions[✅]

Selective cleanup

$removeReaction[$channelID;$messageID;$authorID;❌]
$addMessageReactions[$channelID;$messageID;✅]

Notes

  • To remove all reactions at once, use $clearReactions[channelID;messageID;!all].
  • The emoji must be exactly the same as the one used for the reaction.
  • Custom emojis must be in the format <:name:ID>.

Try it

Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.