Skip to main content
Use the allowlist to restrict a native Minecraft Bedrock Edition server to approved Xbox Gamertags. Minecraft Bedrock Edition uses the term allowlist, although it also accepts whitelist as a command alias.
Add yourself before enabling the allowlist. Otherwise, you may be unable to reconnect until you add yourself through the Purpify game panel console.

​
Before you begin

  • Start the server and wait until it finishes loading.
  • Use each player’s exact Xbox Gamertag, including spaces and capitalization.
  • Put a Gamertag in quotation marks when it contains spaces, such as "Example Player".
  • Confirm that this is a native Bedrock server. For Bedrock players joining through Geyser, use the Java server’s allowlist or permission system.

​
Enable the allowlist

1

Add approved players

Open the game panel console and add each player’s exact Xbox Gamertag. Enter console commands without a leading /.
2

Stop the server

Stop the server before editing server.properties so the running process does not overwrite your change.
3

Enable the allowlist

Open the file manager, edit server.properties, and set allow-list to true. Save the file.
4

Restart the server

Start the server and watch the console for startup errors.
5

Check the approved players

List the allowlisted players and confirm that the expected Gamertags appear.

​
Manage the allowlist

Removing a player from the allowlist prevents the next connection attempt. If the player is already connected, kick the player as well.

​
Fix common problems

Run allowlist list and compare the Gamertag exactly. Add the player again if needed, then run allowlist reload.
Confirm that the server is running native Minecraft Bedrock Edition. Enter commands without / in the game panel console and with / in Minecraft chat.
Geyser provides Bedrock-to-Java cross-play. Manage the player with the Java server’s allowlist or plugin permission system instead of this native Bedrock procedure.