From Minecraft Wiki
Jump to: navigation, search

No command blocks

First introduced

Java Edition Beta 1.3

Information icon.svg
This feature is exclusive to Java Edition.

Manages the server whitelist.

Server ops can always connect when the whitelist is active, even if their names do not appear in the whitelist. The usernames of the whitelisted players are stored in the whitelist.json configuration file.


The command has six variations.

whitelist add <targets>
whitelist list
whitelist off
whitelist on
whitelist reload
whitelist remove <targets>



Specifies the player(s) to add or remove from the whitelist. Must be a player name, a target selector or a UUID.
Entities other than players are not allowed.


Fails if the arguments are not specified correctly, or if <targets> doesn't exist.

On success:

  • add — Adds the player name to the whitelist. The player does not need to be online.
  • list — Displays all player names in the whitelist.
  • off — Disables the server's use of a whitelist.
  • on — Enables the server's use of a whitelist.
  • reload — Reloads the list of player names in white-list.txt (1.7.5 or earlier) or whitelist.json (1.7.6 or later) from disk (used when white-list.txt or whitelist.json has been modified outside of Minecraft).
  • remove — Removes the player name from the whitelist. The player does not need to be online.


[[{{{1}}} 1.3|1.3]]Added /whitelist.