Skip to content

Minecraft: How to Enable and Manage the Whitelist

Learn how to secure your Minecraft game server by managing player access with whitelist features and protecting your gameplay → Find out more now

12 November 20261 min read31 Views0 helpful

Introduction

The Minecraft whitelist is an option to protect your game server by allowing only selected players on the list to connect. By default, Minecraft does not offer a server password option like other games.

Enabling the Whitelist

Activation (Config)

To enable the whitelist, set the command value in the server.properties config file to true. A server restart is required for the change to take effect.

Code
white-list=true

Activation (Chat)

Alternatively, the whitelist option can be enabled in-game or via the Console tab:

Code
/whitelist on			(Enable whitelist)
/whitelist off			(Disable whitelist)

Operator rights are required to enable the whitelist in-game! Otherwise, you can also do this via the Console tab in the game server dashboard. Note that commands there must be entered without the / symbol.

Managing the Whitelist

Adding / Removing Players

Chat

You can add or remove players from the whitelist using the following commands:

Code
/whitelist add PlayerName
/whitelist remove PlayerName

white-list.json

If the player's UUID is known, the player can also be manually added via the white-list.json file. You can access and edit this file via FTP. Instructions for FTP access can be found here: Access via FTP

Code
[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Player1"
  },
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Player2"
  },
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Player3"
  }
]

Reloading the List

If you add players manually, you need to reload the whitelist in-game. This can also be done by command to avoid restarting the server:

Code
/whitelist reload

Displaying the List

If you don't want to open the whitelist file via FTP every time, you can display all players on the whitelist with the following command:

Code
/whitelist list

FAQ

Frequently asked questions

Set white-list=true in the server.properties config and restart the server. Alternatively, enable it with the /whitelist on command in-game or via the Console tab.
Use the /whitelist add PlayerName command in chat, or manually add them via the white-list.json file through FTP if you know the player's UUID.
No, Minecraft does not have a server password option by default. The whitelist is used instead to restrict access to selected players.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.