Skip to content
Minecraft beginner · 10 min read

Minecraft Server Icon: Upload a Custom 64x64 Icon in LoafHub

Add a Minecraft server icon with the LPV5 panel. Upload a PNG or JPEG, the tool resizes it to 64x64 and writes server-icon.png. Restart to see it.

By Bradford Updated

A custom Minecraft server icon is the small image that appears next to your server in a player’s multiplayer list, and the LPV5 panel makes setting one up trivial. You upload a PNG or JPEG, and the tool validates it, resizes it to exactly 64x64, and saves it as server-icon.png at the root of your server. There is no need to resize anything yourself or fight with FTP. This short guide covers the upload, the size and format rules, and the one thing you must do afterwards: restart the server so the icon appears.

What a Server Icon Is

The server icon is a 64x64 image that Minecraft shows beside your server’s name in the multiplayer server list. It is the first visual impression players get of your server, so a clear logo helps your server stand out in a long list of plain default icons. Minecraft reads this icon from a file named server-icon.png in the server’s root folder, which is exactly the file the LPV5 tool creates for you.

Note: The icon is displayed at 64x64 in the multiplayer list, which is why the tool standardises every upload to that size

Note: Loafhosts runs Java Edition servers, where the icon file is server-icon.png in the server root

Open the Server Icon Tool

Like every panel tool, you reach the Server Icon tool by logging in and opening your server. It is a focused, single-purpose tool, so there is not much to learn.

  1. Sign in to LoafHub at hub.loafhosts.com
  2. Open your Minecraft server from your server list
  3. Open the Server Icon tool
  4. Get your image file ready to upload

Tip: Have your logo saved as a PNG or JPEG before you start so the upload is a single step

Upload Your Icon

Uploading is the whole job. You select a PNG or JPEG image, and the tool takes it from there: it validates the file, resizes it to exactly 64x64, and writes it as server-icon.png at the server root. Because the resize is automatic, you can upload a larger square logo and let the tool shrink it, rather than preparing a pixel-perfect 64x64 file yourself.

  1. Open the Server Icon tool
  2. Choose your PNG or JPEG image
  3. Upload it
  4. Let the tool validate and resize the image to 64x64
  5. Confirm the tool saved it as server-icon.png

Tip: Use a square source image — the tool stretches whatever you upload to fit 64x64, so a non-square image will come out distorted. Crop to a 1:1 square before uploading.

Tip: A bold, simple logo reads better at 64x64 than a detailed image with small text

Size and Format Rules

The tool enforces a few rules so your icon works correctly. It accepts PNG and JPEG images and applies size and format limits, rejecting files that do not meet them. If your upload is refused, it is almost always because the file is not a supported format or exceeds the limits, so re-export it as a standard PNG and try again. Whatever you upload that passes the checks is normalised to exactly 64x64.

Warning: Files that are not a supported format, or that exceed the size limits, are rejected, so stick to a reasonable PNG or JPEG

Warning: If an upload is rejected, re-export the image as a standard PNG rather than reuploading the same file

Restart So the Icon Appears

This is the gotcha for this tool. Minecraft loads server-icon.png when the server starts, so a freshly uploaded icon does not show up on the live server until you restart it. After the upload succeeds, restart the server, then refresh your multiplayer list to see the new icon next to the server name.

  1. Confirm the upload saved server-icon.png
  2. Open the Console tab
  3. Restart the server
  4. Wait for it to finish loading
  5. Refresh your multiplayer server list to see the icon

Warning: The icon will not appear until you restart, because Minecraft only reads server-icon.png at startup

Troubleshooting a Missing Icon

If your icon still is not showing after a restart, work through the short list of usual causes. Most of the time it is a caching issue in the client’s server list rather than a problem with the file itself, since Minecraft holds onto the last icon it saw for a server entry. The fix is almost always to refresh the list or remove and re-add the server, which forces the client to read the icon fresh.

Tip: Refresh or re-add the server in your multiplayer list, since the client can cache the old icon

Tip: Confirm the upload actually succeeded and saved server-icon.png, then restart again if you are unsure

Tip: Make sure your source image was a supported PNG or JPEG, as rejected files never get written

Tip: If you replaced an existing icon, remember the new one only takes effect after a fresh restart

Note: A restart is required after every icon change, not just the first one

Note: Because the tool always writes the same server-icon.png file, replacing an icon is simply another upload followed by a restart

Frequently Asked Questions

How do I add a custom server icon in Minecraft?

Open the Server Icon tool in the LPV5 panel, upload a PNG or JPEG, and the tool resizes it to 64x64 and saves it as server-icon.png at your server root. Restart the server and refresh your multiplayer list to see it.

What size does my Minecraft server icon need to be?

The displayed icon is 64x64. You do not have to resize it yourself, though, because the tool automatically resizes whatever supported image you upload to exactly 64x64.

What image formats can I upload for the icon?

PNG and JPEG are supported. The tool validates the file and applies size and format limits, rejecting anything that does not meet them, so use a standard PNG or JPEG.

Why isn’t my server icon showing up?

Minecraft only reads server-icon.png when the server starts, so you must restart after uploading. If it still does not appear, refresh or re-add the server in your multiplayer list, since clients cache the old icon.

Do I need to restart the server for the icon to appear?

Yes. The icon is loaded at startup, so after a successful upload you have to restart the server before the new icon shows in the multiplayer list.

Why was my icon upload rejected?

Uploads are rejected when the file is not a supported format or exceeds the size limits. Re-export the image as a standard PNG or JPEG within the limits and upload it again.

Rate this guide

Tap a star — it helps us decide what to write (and fix) next.