
Microsoft Teams Custom Emoji Size and Upload Guide
Microsoft Teams custom emoji: square JPEG/PNG/GIF under 256K, upload via Your org’s emoji, admin limits, and how to prep a transparent PNG in the browser.
Microsoft Teams finally lets organizations upload custom emoji—the kind you drop into a chat or use as a reaction—without pretending every tenant has the same rules as Discord. The catch: Microsoft’s public Support article is clear about formats and file weight, and almost silent about an exact pixel size. That gap is where people invent “must be 128×128” myths.
This guide sticks to what Microsoft Support actually says, adds admin context from Microsoft Learn, notes the Message Center rollout ceiling carefully, and shows a practical way to prep a square transparent PNG before you hit Add emoji.
What Teams custom emoji are (and are not)
Per Microsoft Support, you create custom emoji from an image or GIF. Once added, people in the organization can use them in messages and as reactions. That includes external users in shared channels—useful for partner projects, messy for brand control if nobody is watching the upload queue.
Custom emoji here are tenant-scoped culture tools, not Unicode characters. Recipients outside your world do not magically get a new keyboard glyph; they see your uploaded asset when it appears in a Teams conversation they can access. Microsoft Learn also notes federated/cross-tenant quirks: outsiders generally will not browse your full custom menu in their own picker the same way, but they can still see emoji you send them.
If your goal is a photo cutout that also works on Discord and Slack, keep a master PNG and resize per platform—see Photo to emoji.
Official upload guidelines (do not invent pixels)
Microsoft Support’s selection guidelines, quoted in spirit:
- Upload JPEG, PNG, or GIF files
- Microsoft recommends square images
- Images are compressed; select files under 256K
That is the published bar. There is no Support line that says “exactly 128×128” or “exactly 256×256.” Community threads often prep GIFs around ~128×128 because it mirrors Discord’s documented max and keeps weight under 256K—say that out loud as a practical habit, not as Microsoft’s pixel law.
| Claim you hear | Reality |
|---|---|
| “Teams requires 128×128” | Not in Microsoft Support. Practical prep size many teams use. |
| “Any huge PNG is fine; Teams will fix it” | Support asks you to pick files under 256K; compression still happens. |
| “Only admins can upload” | Default story is broader; admins may limit who can create or delete. |
| “Delete is instant for everyone” | Your list updates immediately; it may take a few days to disappear for everyone (Support). Learn also mentions up to ~24 hours in admin docs—clear cache if you still see a ghost. |
How to add a custom emoji in Teams (Support steps)
From Microsoft Support:
- In the message box area, open Emoji, GIFs and Stickers, then choose Emoji.
- At the bottom options, select Your org’s emoji.
- Choose Add emoji, pick an image or GIF, and give it a name.
- Select Add emoji again to put it in the org list.
You can also add while reacting: hover a message → More reactions → Your org’s emoji → choose the file and name it.
Anyone can right-click a custom emoji to see who created it and when. If you have delete permission, right-click → Delete → confirm. It drops off your list right away; others may still see it for a while. Support’s tip: clear the Teams cache if a deleted emoji refuses to leave your client.
Admin limits you should expect
Support’s short note: admins may limit who can create custom emoji before they can be used, and may limit who can delete.
Microsoft Learn’s admin article (Custom emojis in Microsoft Teams) fills in the control panel picture:
- Feature can be toggled in Teams admin center → Messaging settings (on by default in the rollout story)
- Messaging policies can allow or block upload and delete (upload often on for users by default; delete often admins-only by default)
- Learn states a tenant can hold up to 5,000 custom emojis
- Learn also notes the feature is not available for EDU tenants (as of that doc)—if you are on education licensing, verify in admin center rather than assuming the consumer/work UI applies
If Your org’s emoji or Add emoji is missing, it is usually policy—not a broken PNG.
Optional Message Center context (MC795750)
When the feature rolled out, Message Center item MC795750 described custom emoji/reactions with a ceiling of up to about 5,000 custom emojis per tenant, default-on behavior, and admin controls for create/delete. That notice is an archived Message Center item tied to the roadmap rollout—not a living Support “how to upload” page. Cite it as rollout history if you need the 5,000 number’s origin; Prefer Learn + Support for day-to-day instructions. Rollout timelines in that archive (Targeted Release mid-2024 through government clouds into 2025) are historical color, not something you configure in the emoji picker.
Preparing a square transparent PNG that Teams will accept
Teams accepts JPEG and GIF too, but for photo cutouts and logo marks you almost always want PNG with transparency. JPEG cannot carry alpha; a white studio background becomes a permanent rectangle on dark Teams themes.
Practical prep recipe (still not an official pixel mandate):
- Start from a clear subject—same “reads at ~32px” test as photo to emoji.
- Crop square.
- Remove the background; export PNG.
- Downscale to something modest—128×128 is a common community working size—and confirm the file is under 256K before upload.
- Name it something people can search (Support’s flow asks for a name; cryptic filenames help nobody in a 400-emoji tenant).
Animated GIF works when motion matters. Keep frames few and the canvas small so you stay under 256K after Teams compresses. Community GIF sizes around 128px are habits, not Support commandments.
Soft browser path on Emoj.si
Emoj.si is a static PNG browser emoji maker. It will not replace Teams admin policy, and it is not a GIF animation studio. What it is good for: building or cleaning a square transparent PNG master you then upload under Your org’s emoji.
Honest pricing: guest/free exports are 512 or 1024 px with a watermark. Paid unlocks watermark-free up to 2048 px and AI background removal with plan quotas. For Teams’ under-256K world you will downscale anyway—just do not upload a watermarked free export to a client-facing tenant if the watermark is unacceptable.
Teams vs Discord vs Slack (short comparison)
| Microsoft Teams | Discord | Slack | |
|---|---|---|---|
| Official size language | Square recommended; no Support pixel lock | Up to 128×128 | Square custom emoji; workspace-managed |
| Weight | Select files under 256K (Support) | Under 256 KB | Practical limits; see Slack UI/docs |
| Formats (common path) | JPEG, PNG, GIF | JPEG/PNG/GIF/WebP (see Discord docs) | PNG/GIF typical |
| Who can add | Org users unless admin limits | Server Manage Emoji (or equiv.) | Workspace permissions |
| Scope | Tenant / org emoji | Per server | Per workspace |
| Deep dive | this page | Discord sizes | Slack add emoji |
If you maintain one brand face across tools, keep a transparent master (512 or 1024) and export Discord’s 128, a square under-256K Teams candidate, Slack’s square, plus Telegram/WhatsApp/Twitch variants from the photo to emoji table. Related size guides: Telegram custom emoji vs sticker, WhatsApp sticker size, Twitch emote sizes.
Graph API footnote (not the primary path)
Developers sometimes see Graph API beta references that talk about uploading custom emoji content (for example PNG/GIF contentBytes style payloads). That is an automation/admin integration path, not how most people add a reaction face on Tuesday afternoon. If you are not writing against Graph, ignore it—use the Your org’s emoji → Add emoji UI above. API shapes also change in beta; do not treat a blog sample as a Support contract.
FAQ
What exact pixel size does Microsoft require?
Support does not publish a mandatory width×height. It recommends square images and files under 256K, in JPEG, PNG, or GIF. Using ~128×128 is a practical prep choice many teams make; it is not an official Teams pixel specification.
Why is Add emoji missing?
Admins can disable the feature or restrict create permission via Teams admin center messaging settings and messaging policies. EDU tenants may not have the feature per Microsoft Learn—confirm with your admin.
Can external guests use our custom emoji?
Support says custom emoji help you communicate with anyone in the organization, including external users in shared channels. Exact visibility still depends on channel type and tenant settings—test with a real guest account if that matters for compliance.
How long does a deleted emoji linger?
Support: deletion removes it from your list immediately, but it may take a few days to no longer appear for everyone. Clear cache if your client is sticky. Learn’s admin note mentions up to about 24 hours for tenant-wide reflection in some descriptions—either way, plan for lag.
Should I upload JPEG or PNG?
For cutouts and logos with transparency, PNG. JPEG is fine for already-flat photos that do not need alpha, but you will see the rectangular backdrop on dark themes.
Does Emoj.si upload into Teams for me?
No. Prep the PNG in the browser, then upload inside Teams yourself (or via whatever admin process your company uses).
Soft next step
Make one square PNG under 256K, name it clearly, and add it under Your org’s emoji. If the picker refuses you, talk to the Teams admin before you blame the file. When you need a transparent master from a photo or simple static art, Emoj.si is there with watermark-on free exports and paid watermark-free / background-removal quotas—then finish the upload in Teams.
For the wider photo pipeline across Discord, Slack, Telegram, WhatsApp, and Twitch, continue with Photo to emoji.
Sources:
- Use custom emoji in Microsoft Teams (Microsoft Support)
- Custom emojis in Microsoft Teams (Microsoft Learn)
- MC795750 – Microsoft Teams: Custom emojis and reactions (Message Center archive)
- Discord emoji size requirements (Emoj.si)
- How to add custom emoji to Slack (Emoj.si)
- Photo to emoji (Emoj.si)
- Telegram custom emoji vs sticker size (Emoj.si)
- WhatsApp sticker size (Emoj.si)
- Twitch emote sizes (Emoj.si)
- Emoj.si