$removeEmoji

The $removeEmoji[] function allows removing a custom emoji from the server using its name.

Syntax

$removeEmoji[name]

Parameters

Parameter	Description
name	The name of the emoji to remove (without the colons :).

Return Value

• Type: String (empty on success)
• Empty string if the removal succeeds.
• Error message if the emoji doesn’t exist or if the bot lacks permissions.

Behavior

• The bot must have the MANAGE_EMOJIS_AND_STICKERS permission.
• The emoji is permanently removed from the server.
• All messages using this emoji will display the text name instead of the image.

Examples

Simple removal

$if[$checkContains[$userPerms;ManageEmojisAndStickers]==true]
  $if[$emojiExists[$noMentionMessage]==true]
    $removeEmoji[$noMentionMessage]
    $sendMessage[✅ Emoji **$noMentionMessage** removed.]
  $else
    $sendMessage[❌ The emoji **$noMentionMessage** does not exist.]
  $endif
$else
  $sendMessage[❌ Permission denied.]
$endif

Secure removal with confirmation

$let[name;$noMentionMessage]
$if[$emojiExists[$name]==true]
  $removeEmoji[$name]
  $title[🗑️ Emoji removed]
  $description[
  **Name:** $name
  **Removed by:** $userName[$authorID]
  ]
  $color[#ED4245]
  $sendMessage[]
$else
  $sendMessage[❌ No emoji named **$name** found.]
$endif

Notes

• The emoji name is case-sensitive.
• Removal is irreversible.
• Always check the emoji’s existence with $emojiExists[] before removing.