Slack Custom Emoji: Exact Size, Format, and Upload Rules (2026)

Slack looks forgiving on the upload page. It says "128 KB max" in the help docs and leaves the rest to discovery. Most rejection errors you will hit do not mention size at all. They say things like "image is too small" or "could not process this image" and you sit there wondering what went wrong, since the file you uploaded is exactly 117 KB and opens fine in Preview.

I ran into this last week building Forgemoji. We render emoji at 256×256 PNG, and Slack kept refusing them with the same generic error. After a week of reading Slack's help center, the developer forum, and reverse-engineering the upload form, here is what Slack actually checks. Six rules, in the order it checks them, with the exact rejection reason for each.

The 6 rules Slack actually enforces

1. 1.Image file size must be 128 KB or less. Slack counts the decoded file, not the base64-encoded one. PNG with too much metadata can blow past 128 KB even when the visible content is tiny.
2. 2.Image dimensions must be at least 18×18 pixels. Slack renders small emoji in the autocomplete picker and on mobile, so anything below 18 px looks broken and gets rejected.
3. 3.Image dimensions must be at most 1024×1024 pixels. Slack crops and resizes the upload on the server side. Anything bigger just gets refused outright.
4. 4.File must be a PNG, JPEG, or GIF. WebP works in 2026 for the message-rendering pipeline, but the custom-emoji uploader still only accepts the three legacy formats. WEBP files fail silently.
5. 5.Animated emoji must be a GIF. Slack will not accept animated PNG (APNG) or animated WebP. The static fallback for animated emoji must also be a separate static image upload.
6. 6.The image must have an alpha channel or be fully opaque. Slack does not accept semi-transparent emoji - the renderer adds a background and treats partial alpha as an error.

What the rejection messages actually mean

Slack shows a tooltip with one of six error strings. Each maps to a different root cause. The mapping is not in the docs.

A safe default that uploads the first time

For 2026, the safest upload is a 128×128 PNG with indexed color (palette mode), no metadata chunks, alpha channel either fully opaque or fully binary transparent. That lands at 8-30 KB for a typical kawaii-style emoji, well under the 128 KB ceiling, and the dimensions are right in the middle of the allowed range. The file will pass the security check because PNG magic bytes are intact.

If you are generating emoji with Forgemoji for Slack, the output is 256×256 PNG with an alpha channel. Two fixes get it into Slack: resize to 128×128 first, or convert to a JPEG with white background if you do not need transparency. The Slack uploader is the bottleneck, not the rendering quality of the source image.

What changed in 2026 vs 2024

Two things. The 18 px minimum is new — Slack bumped it up from 16 px in late 2024 to discourage tiny pixel-art emoji that looked bad in the picker. And animated emoji now require a separate static fallback, where in 2024 you could upload a single animated GIF and Slack would freeze the first frame for static contexts. The static fallback requirement is why most workspaces end up with two uploads for every animated emoji: a 128×128 PNG for static and a 128×128 GIF for the animation.

Sources

Frequently asked questions

Slack has six different rejection rules, only one of which is mentioned in the help docs. These are the questions from workspace admins who keep getting rejected uploads.

What is the size limit for Slack custom emoji?

128 KB decoded. Slack counts the file after decoding, not the base64 or zip-encoded version. A 120 KB file with a lot of metadata can blow past the limit.

What dimensions work best?

128x128 px is the sweet spot. Slack accepts 18-1024 px, but 128x128 renders crisp in the autocomplete picker and the message stream without a server-side resize.

Does Slack accept WebP?

No, as of June 2026. The custom-emoji uploader only accepts PNG, JPEG, and GIF. WebP is fine in the message-rendering pipeline (you can paste a WebP image into a message), but not as a custom-emoji upload.

Can I upload animated Slack emoji?

Yes, as a GIF. Slack does not accept APNG or animated WebP for custom emoji. The animated emoji also require a separate static fallback upload.

How do I batch-upload Slack emoji?

There is no native batch-upload in Slack. Most admins use the Slack API to script it, or Forgemoji exports a ZIP with a manifest that includes the correct filenames for the API script.

Common pitfalls

• •Uploading a 256x256 px source file without resizing — Slack rejects it for "image is too small" on the resized copy
• •Using WebP as the source format — Slack fails silently, the emoji does not appear in the picker
• •Uploading an APNG file expecting it to animate — Slack strips the animation and shows the first frame as static

Extra reading

The Slack emoji cap is enforced per-workspace, not per-user. A workspace on the free plan gets 50 custom emoji slots. Slack Pro adds 50 more, Business+ adds 50 more, and Enterprise Grid adds 50 more per active region. The cap is reset by deletion — removing an unused emoji frees the slot, and the new upload succeeds on the first try. Most admins we have talked to rotate the bottom 5-10 emoji out of their workspaces every 6 months to free up slots for new inside jokes. Forgemoji exports a ZIP with a manifest that includes the new filenames and the deletion script for the rotated emoji.

Related guides

• •How to make Discord emoji — uploading to Discord
• •Animated Telegram stickers guide — for the animated side
• •Emoji slang dictionary 2026 — emoji meanings in 2026

Final note

The Slack emoji picker is a learning curve. Most admins do not know that the picker groups emoji by recency — the 20 most-recently-used emoji float to the top, and the rest fall to a "Show more" link. This means the 50-emoji cap on free plans is more generous than it looks: the 50 you actually use cycle to the top, and the rest get retired. Forgemoji exports a ZIP with the exact 50 emoji that fit a single cap rotation.