Minecraft whitelist command: what to type and why it sometimes does nothing
On a Java Edition server the whole job is six commands: whitelist on, whitelist off, whitelist add NAME, whitelist remove NAME, whitelist list and whitelist reload. Type them in the server console without a slash, or send them over RCON from the RCON app on your iPhone; the reply comes back as plain text.
The commands and what each one prints
The server answers every command with one line, so you always know whether it worked. Player names are case-sensitive in the sense that they must be spelled like the real account.
| Command | What it does | Reply |
|---|---|---|
whitelist on | Starts enforcing the list | Whitelist is now turned on |
whitelist off | Lets everyone join again | Whitelist is now turned off |
whitelist add Steve | Adds the account Steve | Added Steve to the whitelist |
whitelist remove Steve | Takes Steve off the list | Removed Steve from the whitelist |
whitelist list | Shows how many players are on it, with names | A count followed by the names |
whitelist reload | Re-reads whitelist.json from disk | Reloaded the whitelist |
Two other replies are worth recognising. Player is already whitelisted means the add did nothing because the name was already on the list. That player does not exist means the name does not match an account, usually a typo.
The two switches in server.properties
white-list=truekeeps the whitelist on after every start. The default isfalse, so a fresh server lets everybody in.enforce-whitelist=truealso kicks players who are online but not on the list the moment the list is reloaded or switched on. The default isfalse, so people already inside stay inside.
Stop the server before you edit server.properties, then start it again. The whitelist on command takes effect immediately, without a restart.
Run them from your phone with the RCON app
RCON has to be enabled on the server first (enable-rcon, rcon.password, rcon.port); the Minecraft RCON guide on this site walks through that. Then:
- On the Servers screen tap the plus button to open Add Server.
- Fill in Server Name and Hostname or IP, set Server Type to Minecraft and check that Port shows 25575.
- Enter the value of
rcon.passwordin RCON Password, tap Test Connection, then Save Server. - Tap the server to open its console and type
whitelist add Steve. Do not type the slash. - Check the result with
whitelist list. Command Suggestions completes the subcommands as you type.
On a server in your own house the first connection makes iOS ask for Local Network access. Allow it, or the app cannot reach a machine on your Wi-Fi.
Why the whitelist command does not work
- The whitelist is off.
whitelist addfills the list, but nothing is enforced until you runwhitelist onor setwhite-list=true. - The name does not exist. You get
That player does not exist. Check the spelling against the Minecraft account, including capital letters. - You edited
whitelist.jsonby hand. The server only reads the file again afterwhitelist reload. - The server runs in offline mode (
online-mode=false). UUIDs are then built from the typed name, so entries copied from an online server do not match andStevediffers fromsteve. Add the names again with the command on that server. - You typed it in game without operator rights. The reply is
Unknown or incomplete command. The server console and RCON need no operator status.
What about Bedrock servers?
The Bedrock Dedicated Server has no RCON and calls its list the allowlist, so the RCON app cannot manage it. This page is about Java Edition.
Questions and answers
How do I whitelist someone on a Minecraft server?
whitelist add followed by their exact account name, then make sure the whitelist is on with whitelist on. The server replies Added NAME to the whitelist when it worked.Do I need to restart the server after whitelist add?
add, remove and on act immediately. You only need whitelist reload after editing whitelist.json by hand, and a restart after editing server.properties.Why does the whitelist command say unknown or incomplete command?
Can I whitelist a player who is offline?
You might also like
- How to use RCON on a Minecraft server with the RCON app · RCON
- Why does Minecraft RCON say connection refused, and how to fix it · RCON