When you assign a custom role icon in Discord, the icon may appear slightly higher or lower than the member name in the member list or chat. This misalignment makes the server look unpolished and can confuse members about which role belongs to which user. The issue is usually caused by a discrepancy between the icon image dimensions and the role icon size Discord expects, or by a cached icon that doesn’t refresh properly. This article explains why custom role icons become misaligned and provides step-by-step fixes to correct the position.
Key Takeaways: Fixing Discord Custom Role Icon Position
- Server Settings > Roles > Edit Role > Icon: Re-upload a square PNG or GIF image exactly 64×64 pixels to correct alignment.
- Ctrl + Shift + I > Application > Storage > Clear site data: Clear Discord’s browser cache in the desktop app to force a fresh icon load.
- Server Settings > Roles > Edit Role > Display role members separately: Enabling this option may visually separate the icon and name, improving perceived alignment.
Why Custom Role Icons Appear Misaligned in Discord
Discord renders custom role icons as small images next to the role name in the member list and chat. The platform expects the icon to be a square image with equal width and height, typically 64×64 pixels. When you upload an image that is not perfectly square, or that has different dimensions, Discord scales it to fit the icon slot. This scaling can cause the icon to appear offset vertically or horizontally relative to the member name text.
Another common cause is a cached version of the icon that does not update when you replace the image. Discord’s desktop app and browser client store assets locally to improve performance. If the cache holds an old version of the icon with different dimensions, the displayed icon may be misaligned even after you upload a correct image.
Finally, certain server themes or custom CSS in Discord’s browser client can shift the position of role icons. If you use a third-party theme or have modified Discord’s appearance, the icon may be pushed out of its intended alignment.
Steps to Fix Misaligned Custom Role Icons
- Prepare a correctly sized icon image
Create or download a square PNG or GIF image that is exactly 64×64 pixels. Use an image editor like Paint, Photoshop, or a free online tool to crop or resize the image to these exact dimensions. Save the file with a transparent background if you want the icon to blend with the role name. - Open Server Settings
Right-click your server name in the channel list and select Server Settings. If you are on a mobile device, tap the server name and then tap the three-dot menu, then select Settings. - Navigate to the role with the misaligned icon
In the left sidebar, click Roles. Find the role that has the misaligned icon and click its name to open the edit screen. - Upload the corrected icon
Under the role name field, click the current icon or the Icon section. Click Upload Image and select your 64×64 pixel square image. Discord will display a preview. Click Save Changes at the bottom of the page. - Clear Discord’s cache to refresh the icon
Press Ctrl + Shift + I on Windows or Cmd + Option + I on Mac to open Discord’s Developer Tools. Click the Application tab. In the left panel under Storage, select Local Storage, then click Clear site data. Confirm the action and close Developer Tools. Restart Discord completely. - Enable display role members separately (optional)
In the same role edit screen, scroll down to Display role members separately. Toggle this option on. This setting moves the role icon and name to a separate section in the member list, which can help visually realign the icon with the name.
If Discord Still Has Issues After the Main Fix
Icon still appears offset after cache clear
If the icon remains misaligned after uploading a square 64×64 image and clearing cache, the problem may be with Discord’s client rendering. Try switching from the desktop app to the browser version at discord.com/app. Log in and check the member list. If the icon appears correctly in the browser, uninstall and reinstall the Discord desktop app to reset its rendering engine.
Role icon appears blurry or pixelated
A blurry icon usually means the uploaded image was smaller than 64×64 pixels and Discord scaled it up. Re-upload an image that is at least 64×64 pixels. For best results, use an image with a resolution of 128×128 pixels or higher, but Discord will still display it at 64×64. Avoid using images with text or fine details that become unreadable at small sizes.
Icon position shifts when using custom themes
If you use a third-party Discord theme via browser extensions or client mods, the theme’s CSS may override Discord’s default icon positioning. Disable the theme temporarily to see if the icon aligns correctly. If it does, contact the theme developer for a fix or choose a different theme that respects Discord’s layout.
Discord Role Icon Image Formats and Dimensions
| Item | Recommended | Not Recommended |
|---|---|---|
| Image format | PNG or GIF (static or animated) | JPG, BMP, or WEBP |
| Dimensions | 64×64 pixels (square) | Non-square dimensions or below 32×32 |
| Background | Transparent | Solid color background |
| File size | Under 256 KB | Over 256 KB |
Discord supports animated GIF icons for roles, but the animation may cause slight visual shifting if the GIF’s first frame is not perfectly square. Always ensure the GIF’s canvas is 64×64 pixels and the first frame is centered.
After applying the fixes above, your custom role icon should sit neatly next to the member name. If you manage a large server, consider standardizing all role icons to the same 64×64 square format to prevent future alignment issues. For advanced control, you can use Discord’s role icon upload API to programmatically set icons with exact pixel dimensions.