$addEmoji

The $addEmoji[] function adds a new custom emoji to the server from an image URL. The emoji can be public or restricted to a specific role.

Syntax

$addEmoji[name;url;(roleID)]

Parameters

Parameter	Description
name	The emoji name (2 to 32 characters, alphanumeric + underscores).
url	The URL of the image (PNG, JPEG, GIF). The image must be publicly accessible.
roleID	Optional - ID of the role allowed to use the emoji. If omitted, the emoji is public.

Return value

• Type: String
• The markup of the created emoji in the format <:name:ID> on success.
• An error message if the URL is invalid, the name is already taken, or permissions are insufficient.

Behavior

• The bot must have the permission MANAGE_EMOJIS_AND_STICKERS.
• The name must be unique among the server’s emojis.
• Limit of 50 standard emojis (more for boosted servers).
• Animated GIFs are accepted and create an animated emoji.

Examples

Simple addition

$if[$checkContains[$userPerms;ManageEmojisAndStickers]==true]
  $let[emoji;$addEmoji[cool;https://example.com/cool.png]]
  $sendMessage[✅ Emoji added : $emoji]
$else
  $sendMessage[❌ Permission denied.]
$endif

Emoji with attachment

$let[url;$getAttachments[$noMentionMessage]]
$if[$url!=]
  $let[firstUrl;$splitText[$url;, ;1]]
  $let[emojiName;$noMentionMessage]
  $let[emoji;$addEmoji[$emojiName;$firstUrl]]
  $sendMessage[✅ Emoji created : $emoji]
$else
  $sendMessage[❌ No image found. Please attach an image to your message.]
$endif

Staff-restricted emoji

$let[staffRole;$roleID[Staff]]
$let[emoji;$addEmoji[confidential;https://example.com/lock.png;$staffRole]]
$if[$emoji!=]
  $sendMessage[✅ Emoji **$emoji** created and restricted to the role <@&$staffRole>.]
$else
  $sendMessage[❌ Error during emoji creation.]
$endif

Validation of the name

$let[name;$message]
$if[$length[$name]<2]
  $sendMessage[❌ The name must be at least 2 characters.]
$elseif[$length[$name]>32]
  $sendMessage[❌ The name must not exceed 32 characters.]
$elseif[$emojiExists[$name]==true]
  $sendMessage[❌ An emoji named **$name** already exists.]
$else
  $let[emoji;$addEmoji[$name;$getAttachments[$noMentionMessage]]]
  $sendMessage[✅ Emoji **$emoji** created !]
$endif

Notes

• The URL must point directly to an image (with extension .png, .jpg, .gif).
• The server has an emoji limit according to its boost level.
• Animated emojis count toward a separate limit.
• The name must only contain letters, numbers, and underscores.