The stealer downloads from GIF hosts and Discord, so some errors come from those services being slow. Here is what each message means.
These are the ones people ask about most. They usually come from the image or GIF host (Tenor, Giphy, Discord's CDN) being slow or the file being too big, not from your server. Most are safe to just retry.
| If you see this | What to do |
|---|---|
| Error: Request failed with status code 504 (or 502) | The GIF or image host was slow or briefly down when the bot tried to download it. Wait a moment and run the command again, try a different GIF, or upload the file directly instead of by link. |
| Error: Request failed with status code 404 | The emoji, sticker or GIF no longer exists at that link. Grab a fresh one and try again. |
| Error: timeout of 15000ms exceeded (or "read ECONNRESET" / "aborted") | The download stalled part way, usually a slow third-party host or a very large GIF. Retry, and prefer a smaller or shorter GIF. |
| Discord API Error: Asset exceeds maximum size / Failed to resize asset | The file is over Discord's limit: 256 KB for emojis, 512 KB for stickers. Shrink it, or pick a smaller image or a shorter GIF. |
| "Emoji name invalid" when the name looks fine | Discord returns that same error for an oversized file too. If the name really is fine, the file is too large, so shrink it. |
| Failed to add the emoji / sticker, then a long Discord message | Almost always the file is too big or an unsupported format. Use a PNG, JPG, GIF or WEBP under the size limit. |
| If you see this | What to do |
|---|---|
| Emoji limit reached | The server is out of emoji slots. Animated emojis have their own separate slots, and boosting the server adds more of both. |
| "Image Too Large" (Exceeds 256 KB for emojis) | Emojis must be under 256 KB. Shrink the image, or use it as a sticker instead (stickers allow up to 512 KB). |
| "Invalid Format" | Use a PNG, JPG, GIF, APNG or WEBP. |
| "Permission Denied" | Adding emojis or stickers needs the Manage Emojis and Stickers permission. Downloading does not. |
| "Rate Limited" | You are going too fast. Wait a few seconds and try again. |
| "This command can only be used in a server" | Run it in a server channel, not in DMs. |