Back to Blog
Guide

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.

Slack Green Team
September 28, 2026
October 26, 2026
5 min read
Share:
discord
emoji
custom emoji
gif

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

RuleRequirement
File sizeUnder 256 KB, static or animated
FormatsJPEG, PNG, GIF, WEBP
DimensionsAny, but 128 x 128 square is the usual choice
Name2 to 32 characters, only letters, numbers and underscores
Who can uploadServer owner, or roles with Create Expressions or Manage Emojis
Slots50 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

  • • The server is out of slots. The 50 static slots fill up fast. Delete old emoji in Server Settings, Emoji, or boost the server.
  • • You do not have permission. Without Create Expressions, the upload button is missing. Ask a server admin.
  • • The file is not a real GIF. A video renamed to .gif, or an MP4 from a GIF site, fails. Download the GIF version or convert it first.
  • • Animated emoji and Nitro. Discord's help says animated slots come with Nitro or Nitro Basic, and using server emoji outside that server also needs Nitro.

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

Guide

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.

Slack Green Team
Guide

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.

Slack Green Team
Ideas

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.

Slack Green Team