Discord Role Icon Size Guide & Specifications
Role icons display next to member display names in chat and server member lists. Here are the exact 64×64 pixel dimensions, 256 KiB upload ceiling, Server Boost Level 2 unlock rules, and practical badge design habits.
Official Discord Role Icon Size and File Specifications
Discord role icons are custom visual badges that display beside a member's name in chat messages, voice channels, and the right-hand server member roster.
Because these icons appear in compact UI locations, Discord enforces strict dimension and file size rules:
If your source artwork is rectangular or high resolution, format it instantly with our in-browser <a href="/tools/role-icon/" class="text-[#3368A0] dark:text-[#66A3BF] font-semibold hover:underline">Discord role icon maker</a>.
| Technical Specification | Official Requirement | Best Practice Recommendation |
|---|---|---|
| Recommended Dimensions | 64×64 pixels | Export at 64×64 or 128×128 pixels (square 1:1) |
| Rendered Display Size | ~16×16 to 20×20 pixels | Design with bold silhouettes visible at 16px |
| Maximum File Size | 256 KiB | Keep PNG files under 100 KiB for instant loading |
| Accepted File Formats | PNG, JPG, WEBP | Always use 24-bit transparent PNG |
| Animation Support | Static only (no animated GIFs) | Use clean vector shapes with crisp outlines |
| Server Requirement | Server Boost Level 2 | Requires 7 boosts from community members |
Server Boost Level 2 Requirements and Retention Rules
Unlike server icons which are free for every server, custom uploaded role icons require the server to reach Server Boost Level 2 (currently 7 community boosts).
Key rules regarding role icon boosts: - Server Boost Threshold: Level 2 unlocks custom role icons, 50 additional custom emoji slots, and 1080p 60fps streaming. - Grace Period if Boosts Drop: If member boosts expire and your server drops below Level 2, your configured role icons are not deleted. They remain saved in role settings, but become hidden from member names until the server regains Level 2. - Using Server Emojis as Role Icons: Even if you do not upload a custom image file, Level 2 allows you to select any existing server emoji or standard Unicode emoji as a role badge.
If you are also setting up server branding, see our guides on server icon sizing and complete Discord dimension specs.
Always check Server Settings → Server Boost Status to verify that your boost tier is stable before announcing new custom role icons to staff.
How to Add Role Icons in Discord Server Settings
Adding a role icon takes less than a minute once your server reaches Boost Level 2:
- Open Discord desktop or web, right-click your server icon, and select Server Settings.
- Click Roles in the left sidebar.
- Select the role you want to customize (e.g., "Moderator", "VIP", or "Tournament Winner").
- Under the Display tab, locate the Role Icon section.
- Click Choose Image to upload your 64×64 PNG, or choose an emoji from your server emoji list.
- Click Save Changes at the bottom of the screen.
Make sure your account has the Manage Roles permission, and ensure your own highest role is higher in the hierarchy than the role you are editing.
You cannot edit roles higher than your own highest role, even if you are an administrator, unless you are the server owner.
Design Habits for Crisp 16px Role Badges
Because role icons render at roughly 16 to 20 pixels in chat, designs that look gorgeous at 500 pixels can turn into an illegible blur in Discord.
Keep these design principles in mind: - Avoid Words and Numbers: At 16 pixels, letters turn into smudged pixels. Use symbolic shapes like crowns, shields, stars, swords, or badges instead. - Maintain High Contrast: Your icon will sit against dark mode (#313338) and light mode (#FFFFFF). Add a thin 1px contrasting border around dark artwork. - Fill the 64×64 Canvas: Do not leave massive empty margins around your symbol. Let the graphic occupy 85% to 90% of the canvas. - Use Transparent Backgrounds: Square white boxes behind icons look amateurish in dark mode. Always export as PNG with alpha transparency.
For resizing existing icons without losing sharpness, use our Discord image resizer.
/* Recommended role icon export parameters */
canvas-width: 64px;
canvas-height: 64px;
color-depth: 32-bit PNG (RGBA);
compression: lossless;
safe-padding: 4px;Role Hierarchy and Chat Icon Precedence
A Discord member can hold dozens of server roles at the same time. If several of those roles have custom icons assigned, Discord will only display one single icon next to their name in chat.
Discord determines which icon to display based strictly on Role Hierarchy: - The role placed highest in Server Settings → Roles takes priority. - If a member has both a "Moderator" role (higher) and a "Supporter" role (lower), only the Moderator icon displays beside their chat messages. - The only way to change which icon appears is to drag the preferred role higher in the server role list.
Keep this in mind when organizing role rewards so higher staff and contributor tiers do not get overridden by lower cosmetic roles.
Discord chat does not stack multiple role icons side-by-side. The highest positioned role in your hierarchy always claims the slot.
Crop and Export 64×64 Role Icons Instantly
Format custom role icons to exact 64×64 pixel dimensions under 256 KiB with high contrast and transparent backgrounds.
Open Role Icon Maker →Frequently Asked Questions
What is the exact Discord role icon size?
The recommended size for Discord role icons is 64×64 pixels, with a maximum file size of 256 KiB. Discord accepts PNG, JPG, and WEBP formats.
Do role icons require Server Boost Level 2?
Yes. Custom role icons require Server Boost Level 2, which requires 7 active boosts from server members. Once unlocked, you can assign icons to unlimited roles.
Can Discord role icons be animated GIFs?
No. Discord role icons must be static images. Animated GIFs are not supported for role icons, even with Server Boost Level 3.
Why is only one role icon showing if a member has multiple roles?
Discord only displays the icon from the highest role in your server role hierarchy. To change which icon shows, drag that role higher in Server Settings.
Can I use custom server emojis as role icons?
Yes. When editing a role in Server Settings, you can choose to select any existing custom server emoji or standard Unicode emoji instead of uploading a file.