Discord Emoji Too Big? How to Get It Under 256 KB
Discord rejects custom emoji over 256 KB. Resize the image to 128 x 128 pixels, and for a GIF lower the colors and drop frames until it fits. Free resizer, gifsicle and ffmpeg commands, and the other upload rules that cause errors.
On this page
Discord says an emoji is too big when the file is over 256 KB. Discord's help center states that custom emojis must be under 256 KB and use JPEG, PNG, GIF or WEBP. The fix is to resize the image to 128 x 128 pixels. For an animated GIF, also lower the number of colors and drop frames until the file is under the limit. Pixel dimensions do not matter to the error; only the file size does.
Our free emoji resizer does this in your browser and keeps the animation. It was built for Slack's stricter 128 KB limit, so anything it outputs also passes Discord's 256 KB.
Discord custom emoji requirements
| Rule | Requirement |
|---|---|
| File size | Under 256 KB, static or animated |
| Formats | JPEG, PNG, GIF, WEBP |
| Dimensions | Any, but 128 x 128 square is the usual choice |
| Name | 2 to 32 characters, only letters, numbers and underscores |
| Who can upload | Server owner, or roles with Create Expressions or Manage Emojis |
| Slots | 50 static per server by default; animated slots need Nitro or Nitro Basic, and server boosts add more |
The name rule causes the second most common failure. party-cat fails because of the hyphen; party_cat works.
Discord's emoji limits, read from its code
Discord's help center gives the 256 KB rule. The web app that discord.com serves holds the exact numbers. We printed them on 26 October 2026 with this script:
import re, urllib.request
UA = {"User-Agent": "Mozilla/5.0 (Macintosh) Chrome/141"}
get = lambda u: urllib.request.urlopen(urllib.request.Request(u, headers=UA), timeout=60).read().decode("utf-8", "ignore")
html = get("https://discord.com/app")
print("build", re.search(r"BUILD_NUMBER\W+(\d+)", html).group(1))
for src in re.findall(r'src="(/assets/web\.[^"]+\.js)"', html):
js = get("https://discord.com" + src)
m = re.search(r"let \w=(\d+),\w=(\d+),\w=(\d+),\w=(/[^/]+/g),\w=(\d+),\w=(\d+),", js)
if m and "EMOJI_MAX_FILESIZE" in js[m.start() - 600:m.start()]:
slots, more, name_max, name_re, kb, size = m.groups()
print("EMOJI_MAX_FILESIZE:", size, "bytes =", int(size) // 1024, "KB")
print("EMOJI_MAX_LENGTH (name):", name_max)
print("not allowed in a name:", name_re)
print("DEFAULT_EMOJI_SLOTS:", slots)
Output:
build 649389
EMOJI_MAX_FILESIZE: 262144 bytes = 256 KB
EMOJI_MAX_LENGTH (name): 32
not allowed in a name: /[^a-zA-Z0-9_]/g
DEFAULT_EMOJI_SLOTS: 50
So the limit is 262,144 bytes (256 x 1,024), not 256,000. Emoji names can be up to 32 characters, and anything other than letters, numbers and underscores is not allowed, which is why a hyphen breaks a name. A server starts with 50 emoji slots.
How to fix "emoji too big"
- Check the file size. On Mac, right-click the file and choose Get Info. On Windows, right-click and choose Properties. Anything over 256 KB fails.
- Resize to 128 x 128. Emoji show small in Discord, so a phone photo at 1080 pixels carries about 70 times the pixels it needs. A 128 x 128 PNG is almost always well under the limit.
- For a GIF, cut colors, then frames. Colors cost the least to cut. Frames come next. Shortening the clip is the last resort.
- Upload again. Open Server Settings, the Emoji tab, and Upload Emoji. On desktop you can also open the emoji picker and choose Add Emoji, which opens Discord's Emoji Studio to crop and name the emoji.
Resize a GIF for a Discord emoji without losing the animation
In the browser. Drop the GIF into our emoji resizer, pick 128 px and Crop to square or Fit whole image, and download. It scales every frame, then lowers colors, size and frame count in that order until the file is under 128 KB. The checklist shows the final size and frame count before you download. The file never leaves your computer.
With gifsicle (Mac: brew install gifsicle):
# resize to 128 x 128, cut to 64 colors, optimize
gifsicle --resize 128x128 --colors 64 -O3 input.gif -o emoji.gif
ls -lh emoji.gif # check it is under 256K
With ffmpeg, which can also lower the frame rate:
# 12 frames per second, 128 px wide, 64-color palette
ffmpeg -i input.gif -vf "fps=12,scale=128:-1:flags=lanczos,split[a][b];[a]palettegen=max_colors=64[p];[b][p]paletteuse" emoji.gif
If the result is still too big, try 96 pixels or 32 colors. Emoji show at small sizes in chat, so the difference is hard to see.
We ran both commands on 26 October 2026 (gifsicle 1.98, ffmpeg 8.1.1) on a 480 x 480 test GIF of 75 frames that ffmpeg drew from its built-in test pattern:
input.gif 1,070,174 bytes, 75 frames, 480x480
emoji-gifsicle.gif 105,440 bytes, 75 frames, 128x128
emoji-ffmpeg.gif 91,003 bytes, 36 frames, 128x128
Both outputs came in well under Discord's 262,144 bytes, and the gifsicle one also passes Slack's 128 KB. gifsicle kept every frame. ffmpeg kept 36 of 75 because fps=12 drops frames, so its GIF plays the same 3 seconds less smoothly.
Other reasons Discord will not take your emoji
Make an emoji from scratch instead
The full walkthrough, from picture to upload, is in how to make a custom emoji for Discord. If you are starting from a picture or a word, the emoji maker makes a square PNG or animated GIF with effects like intensifies, spin and party, sized for Slack and small enough for Discord too. For Slack's own limits and upload steps, see how to add custom emoji to Slack and Slack GIF size limit. A GIF stays animated as a Slack emoji, but not as a Slack profile photo, which keeps only the first frame in our upload test in can you have a GIF profile picture on Slack. For Discord statuses, see how to set a custom status on Discord.
FAQ
Why does Discord say my emoji is too big? The file is over 256 KB. Resize it to 128 x 128 and, for a GIF, cut colors and frames.
What size should a Discord emoji be? 128 x 128 pixels and at most 262,144 bytes (256 KB).
What is the Discord animated emoji size limit? The same 256 KB. Animated emoji are GIFs, and the extra animated slots need Nitro or Nitro Basic.
How do I resize a GIF for Discord without losing the animation? Use a tool that resizes every frame, such as our emoji resizer, gifsicle or ffmpeg.
Can a Discord emoji name have a hyphen? No. Use letters, numbers and underscores, at least 2 characters.
Related Articles
How to Make a Custom Emoji for Discord, With a Free Emoji Maker
To make a custom Discord emoji, crop an image to a square, keep it under 256 KB, name it with letters, numbers and underscores, and upload it with Add Emoji in the emoji picker or Server Settings, Emoji. How to make one from a photo, a GIF or text for free, add animation, and use it in other servers.
How to Make an Emoji From a Video (Slack and Discord)
To turn a video into an emoji, cut 1 to 3 seconds, crop it to a square, scale it to 128 x 128 and save it as a GIF under 128 KB for Slack or 256 KB for Discord. One tested ffmpeg command, a script that finds the frame rate and colors that fit, and a free browser tool that shrinks the GIF for you.
AI Slack Emoji Generator: Prompts, Tools and the 128 KB Rule
Any AI image tool can draw a Slack emoji. Prompts that read at 22 pixels, the AI emoji tools in the top results, and what Slack really does with a large AI image, tested.