HOW TO SET A MINECRAFT SERVER ICON
Learn the exact process to customize, upload, and troubleshoot a server-icon.png on any Minecraft hosting dashboard, proxy network, or local server folder.
MINECRAFT SERVER ICON SPECIFICATIONS
Before uploading, confirm that your image conforms to these strict requirements. Incorrectly formatted files are the primary reason icons fail to display.
| Requirement | Specification Standard | Importance |
|---|---|---|
| Dimensions | Exactly 64 x 64 pixels | Mandatory. Larger or smaller sizes are rejected by client. |
| Filename | server-icon.png | Mandatory. Case-sensitive name. Must be lowercase. |
| File Format | PNG (.png) | Mandatory. JPG, JPEG, and GIFs are not read by server. |
| File Size Limit | Recommended under 15 KB (max 100 KB) | Keeps ping query times fast and prevents dashboard upload failures. |
| Color Profile | 8-bit or 24-bit RGB / RGBA (transparency) | Standard web colors ensure consistent colors across monitors. |
Why 64x64 Matters
Minecraft clients allocate a fixed 64x64 pixel square space for server icons. Uploading any other dimension, even in correct PNG format, results in the server ignoring the file and rendering the default icon instead.
PNG Compression Benefits
Our generator creates optimized, compressed PNGs. This minimizes data payload size, meaning your server logo loads instantly even for players with high-latency connections.
Linux Case-Sensitivity Warning
Almost all commercial Minecraft server hosts run on Linux. In Linux systems, server-icon.png and Server-Icon.png are completely different files. Ensure the name is fully lowercase!
WALKTHROUGHS BY PANEL & SERVER TYPE
Different server styles require slightly different approaches. Follow the custom walkthrough that applies to your current hosting infrastructure.
Pterodactyl & Multicraft Panels
Most modern Minecraft control panels utilize Pterodactyl or Multicraft panel software. It is extremely easy to upload your icon using the web dashboard's integrated file manager:
- Open your Minecraft server control panel dashboard (such as Pterodactyl or Multicraft).
- Click on File Manager located in the panel's navigation menu.
- Verify you are in the default base directory (containing the files
server.propertiesandbanned-players.json). - Click the Upload button at the top right of the file manager interface.
- Drag your downloaded
server-icon.pngfrom your local storage and drop it into the upload box. - Confirm the upload status reaches 100%, then click back to the Console view and click Restart to load the icon.
Self-Hosted Linux VPS / Dedicated Server (SSH & Terminal)
If you are self-hosting on Ubuntu, Debian, or CentOS, you will need to copy the file using SFTP or curl directly into your server directory:
- Open an SFTP client (like FileZilla or WinSCP) and log in using your server root IP address, SFTP port, username, and password.
- Navigate to your Minecraft game server directory (for example:
/home/minecraft/server/). - Upload the
server-icon.pngdirectly into this directory. - Alternatively, if hosting the image online, SSH into your server, navigate to the folder, and download it directly using command-line tools:
wget https://example.com/your-icon.png -O server-icon.png - Execute the command
screen -r minecraft(or attach your terminal screen process) and type/reload confirmorrestartto enable the logo.
Localhost Developer Servers (Windows & macOS)
For local server environments hosted on your personal gaming computer:
- Locate the directory where you run your server's start batch script (
run.batorstart.sh). - Copy your generated
server-icon.pngfrom your browser's Download folder. - Paste the file directly into that server root folder next to your server jars.
- Go into your Minecraft game client, navigate to multiplayer, and click Refresh to immediately display the icon (local servers apply file updates almost instantly).
WHY IS MY SERVER ICON NOT DISPLAYING?
If your icon is not showing up, run through this simple checklist to identify and fix the issue.
Common Problem: Filename Suffix Case
Double check if the file is named server-icon.png.png or server-icon.PNG. Standard Windows folders hide known file extensions, which sometimes leads to double extension names. Enable 'File name extensions' in Windows File Explorer options to confirm the true file suffix.
Common Problem: Cached Game Client
Minecraft clients cache multiplayer server listing details. If you replaced an older icon with a new design, the game client will often continue loading the old design from cache. Click Refresh on the server browser or restart your Minecraft client to force a server ping update.
FAQ AND KNOWN GOTCHAS
More answers regarding Minecraft server-icon configurations.
No. The official Minecraft Java Edition game client will refuse to load any server icon that is not exactly 64x64 pixels. If you try to upload a 128x128, 256x256, or 512x512 image, it will be ignored, and players will see the default gray three-bar icon. Our free Minecraft server icon converter automatically crops, resizes, and downsamples any photo to the precise 64x64 pixel specifications.
Yes. The filename must be exactly 'server-icon.png' in all lowercase letters. Capitalizations such as 'Server-icon.png', 'server-icon.PNG', or 'Server-Icon.png' will cause the server operating system (especially Linux-based hosts like Ubuntu or Debian) to fail to load the file due to case sensitivity. Ensure the extension is '.png' and not '.jpg', '.jpeg', or '.gif'.
The most common reasons are: (1) The server has not been restarted or reloaded after upload. (2) The file is in the wrong directory, such as a plugins or mods folder instead of the root directory. (3) The filename case is incorrect. (4) Your local Minecraft game client has cached the old icon. You can clear your client cache by clicking the 'Refresh' button on your multiplayer server list page in-game.
Yes! Since the output format is PNG (Portable Network Graphics), transparency is fully supported. Transparent backgrounds can look highly professional, creating a custom shape that blends seamlessly with the dark gray background of the in-game multiplayer server listing screen.
Yes, proxies support server icons. If you run a proxy network using BungeeCord, Waterfall, or Velocity, you should place your 'server-icon.png' file directly in the main root folder of the proxy server (where your config.yml or velocity.toml is located). The proxy will handle serving the icon to players pining the network, and downstream servers (like Hub, Survival, Creative) do not need individual icons unless pinged directly.
No. The Minecraft game client only supports static PNG images for server icons. Animated GIFs or APNG (Animated PNG) files will only render the first frame of the animation as a static image. Avoid using animation formats, as they can also increase the file size unnecessarily.