How to Enable Whitelist on Minecraft Server
Enable and manage a Minecraft server whitelist safely with console commands, player names, whitelist reloads, online-mode notes, and proxy considerations.
Whitelist is a simple way to control who can join a Minecraft server. It is especially useful for private SMPs, maintenance windows, and pre-launch testing.
Basic Commands
whitelist on
whitelist add PlayerName
whitelist list
whitelist remove PlayerName
whitelist off
Use the console if possible. That avoids permission issues and lets the server resolve player identity correctly.
When to Use Whitelist
| Situation | Whitelist useful? | | --- | --- | | Private friend SMP | Yes | | Pre-launch testing | Yes | | Maintenance window | Yes | | Large public server | Maybe, usually temporary | | Proxy network | Use carefully and consistently |
On proxy networks, firewall backend servers so players cannot bypass the proxy. Whitelist is not a replacement for network access control.
online-mode and UUIDs
Whitelist behavior depends on player identity. Changing online-mode or proxy forwarding after players are added can cause confusing whitelist, inventory, permission, and ban behavior.
Read what online-mode does before changing authentication mode.
Fix Whitelist Problems
If a player is blocked even after being added, use the not whitelisted error guide.
FAQ
What command enables whitelist?
Run `whitelist on` in the server console or as an operator.
How do I add a player to whitelist?
Run `whitelist add PlayerName`, then confirm with `whitelist list`.
Should I edit whitelist.json manually?
Use commands when possible. Manual edits can introduce formatting or UUID mistakes.
Related Tools
server.properties Generator
Generate a clean Minecraft server.properties baseline for online mode, max players, difficulty, view distance, simulation distance, and command blocks.
Whitelist Generator
Generate Minecraft whitelist commands for adding, removing, enabling, and reloading whitelist entries from a pasted player list.
LuckPerms Command Generator
Generate LuckPerms commands for groups, permissions, users, prefixes, inheritance, contexts, and safe permission values.
Related Articles
How to Fix You Are Not Whitelisted Error
Fix Minecraft You Are Not Whitelisted errors by checking whitelist status, username spelling, UUID changes, online-mode, proxy networks, and permissions.
What Does online-mode Do in Minecraft?
Understand online-mode in Minecraft server.properties, how authentication works, why UUIDs matter, and when proxies use different backend settings.
Best server.properties Settings for Small SMP
Recommended server.properties settings for a small Minecraft SMP, including online-mode, max players, view distance, simulation distance, whitelist, and safety.