How to set up an allowlist
The allowlist (formerly known as whitelist) restricts access to your server so that only approved players can join. This is useful if you want to run a private server for a specific group of people.
Step 1 — Enable the allowlist
Step 1
Access your Game Panel and navigate to your Minecraft Bedrock server. Once there, go to the Files Config section in the left sidebar.
Step 2
Click on Server Properties to open the visual configuration editor. Locate the ALLOW-LIST toggle and enable it.
Step 3
Click Save content at the top right to save your changes, then restart your server from the Console tab.
Step 2 — Add players to the allowlist
Once the allowlist is enabled, only players you add will be able to join. You can manage the allowlist in two ways.
Method 1 — Console commands
You can add and manage players directly from the Console tab using the following commands:
When using the web-based console, do not include the / at the beginning of the command.
| Command | Description |
|---|---|
allowlist add <username> | Adds a player to the allowlist |
allowlist remove <username> | Removes a player from the allowlist |
allowlist list | Shows all players currently on the allowlist |
allowlist reload | Reloads the allowlist after manual file changes |
After running allowlist add <username>, you should see a confirmation message in the console:
Added Steve to the allowlist
Method 2 — Edit allowlist.json manually
You can also manage the allowlist by editing the allowlist.json file directly.
Step 1
Stop your server from the Console tab. Then go to the File Manager section and open the allowlist.json file in the root directory.
Step 2
The file contains a JSON array with one entry per player. Add players following this format:
[
{"ignoresPlayerLimit": false, "name": "Steve"},
{"ignoresPlayerLimit": false, "name": "Alex"}
]Set ignoresPlayerLimit to true for players who should be able to join even when the server is full.
Step 3
Click Save content to save the file, then start your server again from the Console tab.
If you edit allowlist.json while the server is running, run allowlist reload in the Console to apply the changes without restarting.
✅ That's it! Your server is now set to allowlist-only. If you have any problems, contact us via Discord (opens in a new tab) so we can help you.