☰

Whitelist Error

A player is rejected with 'You are not whitelisted on this server'. The whitelist is on and that player's account is not on it, or it was added incorrectly.

What does this error mean?
With white-list enabled, only listed players may join. The kick means the joining account is not present in whitelist.json, often due to a name change, a typo, or offline-mode UUID issues. 
You are not whitelisted
Most Common Causes
  • The player was never added to the whitelist.
  • A username typo when adding them.
  • The player changed their Minecraft name (the stored entry is outdated).
  • The server runs in offline mode, so UUIDs do not match online ones.
  • whitelist.json edited by hand with bad formatting.
How To Diagnose
  1. Run '/whitelist list' to see who is actually whitelisted.
  2. Confirm the exact current username of the player.
  3. Check whether online-mode is true or false in server.properties.
  4. Inspect whitelist.json for formatting errors if edited manually.
Recommended Fixes
  • Add the player correctly
    Use '/whitelist add <currentName>' so the server fetches the right UUID.
  • Re-add after a name change
    Remove the stale entry and add the player by their new username.
  • Fix offline-mode UUIDs
    On offline servers, whitelist by the offline UUID, or run online-mode for proper UUIDs.
  • Reload the whitelist
    Run '/whitelist reload' after manual edits to apply changes.
Analyze My Log
Frequently Asked Questions

Use the command with the current name on online-mode servers, it stores the correct UUID automatically.

Online mode tracks UUIDs, but a stale name entry can still cause mismatches, re-add the player.

Yes, offline UUIDs differ from online ones, so whitelist entries must use the matching UUID.