Short answer: If Discord will not let you upload an emoji, the problem is usually one of these: you do not have permission, the server is out of emoji slots, the file is over 256 KB, the file format is unsupported, or the emoji name does not meet Discord's naming rules.
Start with the checklist below. Discord can resize and crop during upload on desktop and in the browser, so the fastest fixes are usually permissions, file size, server capacity, or the emoji name.
Fast diagnosis checklist
- Permission: Make sure you are the server owner or have the
Create Expressionspermission. - Server capacity: Check whether the server has room for another emoji, and if you are uploading a GIF, make sure it has animated emoji slots available.
- File size: Keep the upload under 256 KB.
- Format: Use a supported file type: JPEG, PNG, GIF, or WEBP.
- Name: Use at least 2 characters and only letters, numbers, or underscores.
- Client: If you are on mobile, retry on desktop or in the browser first.
Common causes and how to fix them
1. You do not have upload permission
Discord's current support docs say you need the Create Expressions permission to add custom emojis. If the upload button is missing, disabled, or the action silently fails, ask a server owner or admin to enable that permission for your role.
2. The server is full
Every server can add up to 50 custom emojis by default. Discord also gives servers with Nitro or Nitro Basic an extra 50 animated emoji slots. If the server is at capacity, your upload will not go through until someone removes an unused emoji or frees the right slot type.
If a static file uploads fine but a GIF fails, check animated slots specifically.
3. The file is too large
Discord says custom emojis must be under 256 KB. This is the most common reason an upload fails.
- Trim empty transparent space around the artwork.
- Export a smaller canvas, ideally around 128x128 px.
- For GIFs, cut frames, shorten the loop, or simplify motion.
- For static images, re-export as a cleaner PNG or WEBP with less unnecessary detail.
4. The file format or framing is wrong
Discord currently lists JPEG, PNG, GIF, and WEBP as supported upload formats. If you are troubleshooting quickly, use PNG for static emoji and GIF for animated emoji because those are the easiest formats to verify and re-export.
Discord recommends 128x128 px and resizes custom emoji down to 32x32 in chat. Bigger or smaller files can still work, but a square 128x128 export usually gives you the most predictable crop and the easiest path to staying under the size limit.
5. The emoji name is invalid
Discord requires emoji names to be at least 2 characters long and to use only alphanumeric characters and underscores. That meansparty_blobworks, while names with spaces, hyphens, or punctuation can fail.
6. The client is the problem, not the file
Discord's Emoji Studio is available in the desktop app and in the browser, but not on mobile. If the file looks valid and you still cannot upload it on mobile, retry on desktop or in a browser before you spend time reworking the artwork.
Specs worth checking before you retry
- File size: under 256 KB
- Supported formats: JPEG, PNG, GIF, WEBP
- Recommended dimensions: 128x128 px
- Display size in chat: 32x32 px
- Name rules: 2+ characters, letters/numbers/ underscores only
If your upload keeps failing, the fastest next step is usually to rebuild the file cleanly at the right size and export it under the limit.