How do I set a custom server icon?

A custom server icon is the little image players see next to your server in their multiplayer list. Minecraft is picky about the format, so getting the details exactly right is what makes it show up.

The requirements

Your icon must be:

• Exactly 64x64 pixels
• In .png format
• Named exactly server-icon.png
• Placed in the server root (the same folder as server.jar and server.properties)

Step-by-step

1. Prepare an image that is exactly 64x64 pixels, saved as .png.
2. Name it exactly server-icon.png.
3. Open the Files tab and upload it to the server root folder.
4. Restart the server — Minecraft only reads the icon at startup.

Tip: If your image isn't 64x64, resize/convert it first (plenty of free converters exist). Animated icons aren't supported on Java Edition.

Frequently asked questions

My icon isn't showing — what's wrong? Confirm the exact name (server-icon.png), the 64x64 size, the .png format, and that it's in the root folder — not a subfolder. Then restart.

Can I use a .webp file? Some setups historically used .webp, but the standard Java format is server-icon.png. If a .png doesn't show, double-check the name, size, and location.

Do I really have to restart? Yes. Minecraft only loads the icon when the server starts, so the icon won't change until you restart.