---
title: "How to Whitelist Players on a Minecraft Server"
description: "How to whitelist players on a Minecraft server: turning the whitelist on, adding and removing players, and the console commands if you prefer typing them."
url: https://fps.ms/docs/minecraft/how-to-whitelist-players
---
# How to whitelist players on your Minecraft server

A whitelist decides who can join your server. When it is on, only the players on the list can join. Everyone else gets a message that they are not whitelisted.

You manage the whitelist on the **Players** page of your server. You do not need to type commands or edit files.

## Open the Players page

1. Go to [panel.fps.ms](https://panel.fps.ms) and open your server.
2. In the top bar, click **More**, then click **Players**.

![The More menu with Players highlighted](https://assets.docs.fps.ms/minecraft/how-to-whitelist-players/01-open-players-2dcb0d48.webp)

3. Click the **Whitelist** tab.

![The tabs on the Players page with Whitelist highlighted](https://assets.docs.fps.ms/minecraft/how-to-whitelist-players/02-open-whitelist-tab-b6b1f595.webp)

!!! info "Server is sleeping?" "The player lists are read from files on your server. If your server is asleep, click **Wake server and load players** first."

## Add a player

1. Type the player's Minecraft name in **Player name**. Use their Java Edition name, for example `Emma`.
2. Click **Add to whitelist**.

![The Whitelist card with the name Emma typed in and Add to whitelist highlighted](https://assets.docs.fps.ms/minecraft/how-to-whitelist-players/03-add-player-ff736a37.webp)

The player now shows in the list. Repeat this for every player you want to let in, and do not forget to add yourself.

!!! tip "The panel checks the name with Minecraft, so a name that does not exist is refused. Check the spelling if the panel says no."

## Turn the whitelist on

The list only does something when the whitelist is on.

1. Click the **Enforce whitelist** switch at the top of the card.

![The Whitelist card with Emma in the list and the Enforce whitelist switch highlighted](https://assets.docs.fps.ms/minecraft/how-to-whitelist-players/04-turn-on-whitelist-b0fff6ce.webp)

2. The card now says **Only the players below can join this server.**

![The Whitelist card with the switch on and Emma in the list](https://assets.docs.fps.ms/minecraft/how-to-whitelist-players/05-whitelist-enforced-6acb641c.webp)

The change works right away. You do not need to restart your server.

## Remove a player

1. Click the **...** button next to the player.
2. Click **Remove from whitelist**.

To let everyone join again, click the **Enforce whitelist** switch so it turns off. Your list stays saved for later.

## Use the console instead

You can also manage the whitelist from the **Console** page. Type these commands without a `/`:

| Command | What it does |
|-|-|
| `whitelist add Emma` | Adds Emma to the whitelist |
| `whitelist remove Emma` | Removes Emma from the whitelist |
| `whitelist on` | Turns the whitelist on |
| `whitelist off` | Turns the whitelist off |
| `whitelist list` | Shows everyone on the whitelist |

---

[FPS.ms](https://fps.ms/index.html.md) · [All pages](https://fps.ms/llms.txt) · [Documentation](https://fps.ms/docs/llms.txt)