The Not Whitelisted error ('You are not whitelisted on this server') means the server operator has restricted access to a list of approved players. Your Minecraft account is not on that list. This is entirely a server configuration issue — the fix requires the server operator to add you.
What does Not Whitelisted mean in Minecraft?
Minecraft servers can enable a whitelist (white-list.json) that restricts connections to approved usernames. When you try to join a whitelisted server without being on the list, the server immediately rejects your connection with this message.
Why you might not be whitelisted
Common reasons: the server owner has not added you yet, your Minecraft username recently changed (whitelist entries use UUID but old servers may still use username), or you are connecting to the wrong server address.
For server operators
To add a player to the whitelist, run /whitelist add <username> in the server console. If the server uses a plugin-based whitelist, the command may differ. Enabling whitelist: run /whitelist on. Ensure the whitelist.json is correct and up to date.
How to fix step by step
- 1Contact the server operator and ask them to add your Minecraft username to the whitelist.
- 2Verify you are connecting to the correct server IP — it is easy to accidentally join a different server.
- 3If you recently changed your Minecraft username, ask the operator to add your new name.
- 4For operators: run /whitelist add <username> in the console, then /whitelist reload.
How NOT-WHITELISTED differs from related codes
- Error FAILED-TO-CONNECT: Minecraft Java or Bedrock could not reach the multiplayer server. (server or client)
- Error DISCONNECTED: Minecraft ended your multiplayer session with a generic disconnected message. (server or client)