How do I set up and manage a whitelist?

MinecraftUpdated 23 Jul 20261 min read
On this page
  1. Turning on and managing the whitelist
  2. Frequently asked questions

A whitelist limits your server to a specific list of approved players — perfect for private survival worlds and friend groups. You manage it entirely from the Console.

Turning on and managing the whitelist

In the Console:

  1. whitelist on — enable the whitelist.
  2. whitelist add PlayerName — do this for each allowed player.
  3. whitelist reload — apply your changes.

To manage it later:

  • whitelist remove PlayerName — revoke access.
  • whitelist off — disable the whitelist entirely.

Names are stored in whitelist.json, which you can view in the Files tab.

Tip: Add yourself to the whitelist before turning it on, so you don't accidentally lock yourself out.

Frequently asked questions

I locked myself out — now what? Use the Console (which isn't affected by the whitelist for commands) to whitelist add your name, then reconnect.

Do I need to restart after changes? No — whitelist reload applies changes immediately without a restart.

Where are whitelisted players stored? In whitelist.json in your server root. You can inspect or edit it via the Files tab if needed.

More in Whitelist, OP, Permissions, Bans

All Server Troubleshooting & Crashes guides

Still stuck?

Humble AI, our team and the Discord are a message away.