GAME SERVER HOSTING: 50% OFF first order with code GHOST50
Minecraft background

How to Change Your Minecraft Server Icon

Learn how to change the server icon on your Minecraft Java Edition server by uploading a 64x64 server-icon.png to your server's root directory.

This is what you do if you want to change the server icon of your Minecraft server. The icon shows next to your server name in the Multiplayer server list. Minecraft reads it from a file called server-icon.png in your server's root directory. This works on Java Edition only. Bedrock Edition servers don't use server icons.

Preparing Your Server Icon

Minecraft only loads a 64x64 PNG. It ignores any other size or format.

  1. Open your image in an image editor and resize it to 64x64 pixels.
  2. Save it as a PNG named server-icon.png.
Tip

Use a square image for the best result. Wide or tall images will look squashed once resized to 64x64. Transparent backgrounds stay transparent.

Uploading Your Server Icon

  1. Log in to the GhostCap Panel and Stop your Minecraft server.
  2. Go to File Manager. You can also use SFTP if you prefer.
  3. Upload server-icon.png to the root directory of your server, next to server.properties. Replace the old file if there is one.
  4. Start your server.

Troubleshooting

The New Icon Doesn't Show

  • Restart your server after changing the icon. Minecraft loads server-icon.png when the server starts.
  • In the Multiplayer menu, click Refresh. Your game keeps the old icon until it pings the server again.
  • Check the file name. It must be server-icon.png in lowercase. Windows hides file extensions by default, so make sure the file isn't named server-icon.png.png.

Couldn't Load Server Icon

If your Console shows Couldn't load server icon or Must be 64 pixels wide, the file is the wrong size or format. Make sure it's a PNG that is exactly 64x64 pixels and upload it again.

Note

Only Minecraft Java Edition servers use server-icon.png. Bedrock Edition servers don't read this file.