Minecraft Wiki

The Minecraft Wiki is no longer considered as official by Microsoft and therefore several changes are required to be made, including to the wiki's logo. Please read this announcement for more information.


Minecraft Wiki
Minecraft Wiki
Permission level

3‌[JE only]
4‌[BE only]


No command blocks
Dedicated server only
Cheat only‌[BE only]

Whitelist is used to manage server whitelists.

In Java Edition, server operators can always connect when the whitelist is active, even if their profiles do not appear in the whitelist. In Bedrock Edition, players must be whitelisted regardless of operator status. The profiles of the whitelisted players are stored in the whitelist.json configuration file.


whitelist add <targets> (Java Edition)
whitelist add <name: string> (Bedrock Edition)
Adds the player profile(s) to the whitelist. The player does not need to be online.
whitelist list
Displays all player profiles in the whitelist.
whitelist off
Disables the server's use of a whitelist.
whitelist on
Enables the server's use of a whitelist.
whitelist reload
Reloads the list of player profiles in whitelist.json from disk (used when whitelist.json has been modified outside of Minecraft).
whitelist remove <targets> (Java Edition)
whitelist remove <name: string> (Bedrock Edition)
Removes the player profile(s) from the whitelist. The player does not need to be online.


JE: <targets>: game_profile

Specifies the player profile(s) to be added to or removed from the whitelist.
Must be a collection of game profiles (player profiles), which can be a player name (must be a real one if the server is in online mode), or a player-type target selector.

BE: <name: string>: basic_string

Specifies the player name(s) to be added to or removed from the whitelist.
Must be either a single word (no spaces) or a quoted string.


CommandTriggerJava Edition
anythe arguments are not specified correctly Unparseable
/whitelist onthe whitelist is already enabled Failed
/whitelist offthe whitelist is already disabled
the target selector fails to resolve to one or more online players
/whitelist add <targets>there's no new new player profile added to the whitelist
/whitelist remove <targets>all specified profiles is not in the whitelist
anyOn successManages the whitelist.


CommandEditionSituationSuccess Count/execute store success .../execute store result ...
anyJava EditionOn failN/A00
/whitelist on
/whitelist off
/whitelist reload
On successN/A11
/whitelist listOn successN/A1the number of players in the list.
/whitelist add <targets>On successN/A1the number of new player profiles added to the whitelist.
/whitelist remove <targets>On successN/A1the number of player profiles removed from the whitelist.


Java Edition Beta
1.3Added /whitelist.
Bedrock Edition
1.16.0releaseAdded /whitelist.
1.17.0beta to /allowlist.
releaseReverted back to /whitelist