/whitelist Command in Minecraft Java Edition

Manage Your Server Player Whitelist

Java EditionServer AdminPermission: Level 3Bedrock version →

The /whitelist command in Minecraft Java Edition lets server admins control which players are allowed to join the server. You can turn the whitelist feature on or off, add or remove specific players, view everyone currently on the list, or reload the list.

Server owners use this command when they want to keep a server private for friends or approved community members. You need Level 3 (Server admin) permission to run any form of this command.

Syntax (Java 26.3, 6 forms)

  1. /whitelist add <targets>
  2. /whitelist list
  3. /whitelist off
  4. /whitelist on
  5. /whitelist reload
  6. /whitelist remove <targets>

The forms you will use most

/whitelist add <targets>
Adds one or more players to the server whitelist.
/whitelist remove <targets>
Removes one or more players from the server whitelist.
/whitelist list
Displays all player names currently on the whitelist.
/whitelist on
Enables the whitelist so only listed players can connect.
/whitelist off
Disables the whitelist so anyone can join the server.
/whitelist reload
Reloads the list of whitelisted players.

Arguments

ArgumentTypeWhat it means
<targets>playerSpecifies the player or players to add or remove, using either a direct player name or a target selector that matches players.

Examples

Version history

Measured from the game files of every Java release from 1.13 to 26.3.

  1. 1.13 Already in the game in 1.13, the oldest Java version we track.

Tips

Common mistakes

Java vs Bedrock

In Minecraft Bedrock Edition, this command is called /allowlist instead of /whitelist, and it uses the syntax /allowlist <action: AllowListAction> [name: string].

See /allowlist in Bedrock Edition →

FAQ

How do I turn the whitelist on in Minecraft Java Edition?

Type /whitelist on in the game chat or server console with Level 3 admin permissions to enable the whitelist.

How can I see who is on my server whitelist?

Run the command /whitelist list to view the names of all players currently approved to join.

What is the whitelist command in Bedrock Edition?

Bedrock Edition uses the /allowlist command with the syntax /allowlist <action: AllowListAction> [name: string].

Related commands

/ban/ban-ip/banlist/datapack/deop/fetchprofile/kick/list/op/pardon/pardon-ip/publish/reload/save-all/save-off/save-on

More on 9Minecraft