A whitelist makes your server private: only the players on it, and your operators, can join. Turn it on with the Whitelist switch in Settings, Server Properties (Java), then add your friends on the Players page. A ban does the opposite: it keeps one player or address out of a server everyone else can join.
Turn the whitelist on or off
- Open your server in the panel and click the Settings tab.
- Under Config files, click Server Properties (Java).
- Switch Whitelist on to make the server private, or off to let anyone with the address join.
- To kick players who are already online and not on the list, also switch Enforce whitelist on.
- Click Save & restart.

Before you turn it on, add yourself and your friends, or make yourself an operator: operators can always join while the whitelist is on.
Which is the default? The setup asks Who can join? and writes your answer: Anyone with the address leaves the whitelist off, Only players I add turns it on. Minecraft 26.3 and newer turn the whitelist on in a new server.properties file of their own, so check the switch if your server was not set up through the panel's setup.
Add and remove players
The easiest ways are in the panel, and they work whether the server is running or stopped:
- Players page: Players in the left menu, Whitelist tab, type the Minecraft name and click Add. Remove takes someone off. See How to manage players on your Minecraft server with the Players page.
- Invite link: on the Play with friends card, Invite friends makes a link your friends use to add their own names. See How to invite friends to your Minecraft server with an invite link.
You can also type commands in the Console tab while the server is running, without a slash:
whitelist add Alex
whitelist remove Alex
whitelist list
whitelist on
whitelist off
whitelist reload
whitelist on and whitelist off turn it on or off on the running server. To set it in the panel, use the Whitelist switch above. whitelist reload reads whitelist.json again after you edited it by hand in Files. The Reload Whitelist task on Quick Tasks sends the same command: How to use Quick Tasks on your Minecraft server.
With Online mode on, use the player's real Minecraft name. Keep online mode on: without it a whitelist cannot tell apart two people who type the same name. See Online mode and offline mode on a Minecraft server.
Ban and pardon
- Players page, Bans tab: Ban keeps a player out until you click Pardon. Ban address blocks an IP address, whatever name is used.
- Active players card: the menu on an online player's name has Kick and Ban.
- Console:
ban Alex
ban-ip 203.0.113.5
banlist
pardon Alex
pardon-ip 203.0.113.5
An address ban also blocks everyone who shares that address, such as people in the same household. Bans are kept in banned-players.json and banned-ips.json. The full steps are in How to kick, ban and unban players on your Minecraft server.
In the game
Operators can type the same commands in chat with a slash, for example /whitelist add Alex. whitelist, ban, pardon and kick need operator level 3 or higher. The Console needs none. See How to op yourself and manage permissions on your Minecraft server.
Bedrock players
Bedrock players who join your Java server through crossplay need to be on the Java whitelist too. An invite link adds them by their Xbox gamertag. See How to run a Minecraft server for Bedrock players.
Related
- Players see You are not white-listed on this server
- Minecraft commands for server owners
- How to invite friends and give them access is about access to the panel, not to the game.



