Upload a PNG skin

Use the skin upload page to generate a command from a skin PNG. The page does not connect to your Minecraft server. You apply the result yourself.

Before you start

You need a Minecraft skin PNG and permission for skinsrestorer.command.set.url. The website accepts PNG files up to 5 MB. Use a standard skin template, rather than a screenshot or an HD texture.

Read classic and slim models if you are unsure which model matches your image.

Generate and apply

Open Upload.
Select Browse files and choose your PNG.
Check the preview and choose Classic or Slim.
Choose Axolotl or Official under Upload method.
If you want a cape, select one from the available cape list.
Select Generate /skin url.
Copy the generated command.
Paste the command into your Minecraft chat.

Keep the generated URL inside quotation marks. The command includes the model selected on the page. A result can use a MineSkin URL or an opaque skinsrestorer-axolotl:// value.

Copy that value exactly. An Axolotl value is for the command, rather than a browser link.

Command shape, not a ready-to-use texture URL

/skin url "https://textures.minecraft.net/texture/TEXTURE_HASH" slim

Wait for a success message. Ask another player to check your skin, then reconnect to check persistence.

API key and capes

The Axolotl method offers supported capes without your own key. The Official method accepts a MineSkin key and checks its cape grants.

A selected cape with Axolotl uses the proxy route. Official uploads and uploads without a selected cape use MineSkin directly.

The key field on the website and api.mineskinAPIKey on your server are separate. Read MineSkin integration for queues, limits, and privacy.

The available list contains supported existing capes. It does not accept arbitrary cape images or transfer cape ownership to your account.

If generation fails

Invalid image: Export a standard PNG skin template again.
Queue or rate limit: Wait for the queue to finish before you retry.
Unauthorized key: Check the key and its current account grants.
Arm artifacts: Generate again with the correct model.
Command denied: Check URL permissions and restrictions.

To give the result a reusable server name, create a custom skin.