/list
Shows all players currently connected to the server, optionally with their UUIDs.
Overview
Shows all players currently connected to the server, optionally with their UUIDs. In vanilla Minecraft Java Edition it is one of the server commands and has been available since version 1.0.
It is invoked as /list [uuids] and accepts one optional argument ([uuids]).
This command is available to all players (permission level 0). The output shows the player count and their names.
It reports only players who are currently connected, never offline accounts.
The output opens with the online count against the server's max-players slots (for example "There are 3 of a max of 20 players online") followed by the comma-separated names.
Adding the optional uuids literal appends each player's unique account UUID, which is handy for matching names to entries in ops.json, banned-players.json or whitelist.json.
Syntax & Arguments
/list [uuids]The full syntax is /list [uuids]. Angle brackets < > mark required arguments and square brackets [ ] mark optional ones; a vertical bar | between words means you pick exactly one of those literals. Every argument is optional, so the bare command is valid on its own. The argument [uuids] may be omitted, in which case the documented default applies.
- uuids
- Optional, of type a literal. If specified, also displays each player's UUID.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| uuids | literal | Optional | If specified, also displays each player's UUID. |
Examples
The 2 examples below are ready to copy and adapt. For instance, /list shows the number of online players and their names. Each example varies the arguments to show a different real use of /list; read the note under every snippet to see exactly what changes.
/listShows the number of online players and their names.
/list uuidsShows online players along with their UUIDs.
Permission Level & Requirements
/list sits at permission Level 0 - All Players, which means any player can run it without operator status.
Permission level 0 — every player may run it.
This reference describes the Java Edition 1.21 form of the command; Bedrock Edition may use slightly different argument formats.
Common Mistakes
- Expecting /list to show offline players, it only shows currently connected players.
Notes
This command is available to all players (permission level 0). The output shows the player count and their names.
Related Commands
If /list is part of your toolkit, the commands below are the ones you will most often reach for alongside it: /whitelist and /op. They cover closely related tasks, so the links above jump straight to each one.
Frequently Asked Questions about /list
What does the /list command do in Minecraft?
Shows all players currently connected to the server, optionally with their UUIDs. It belongs to the server command group and was added in Java Edition 1.0.
What is the correct syntax for /list?
/list [uuids]. The required arguments are none, and the optional one is uuids.
What permission level does /list need?
It requires permission Level 0 - All Players. No operator status is needed.
What is a common mistake when using /list?
Expecting /list to show offline players, it only shows currently connected players.
Can you give an example of /list in use?
Yes. /list uuids — shows online players along with their UUIDs.
Does /list show offline or whitelisted players?
No. /list only shows accounts connected to the server right now. To see who is allowed on rather than who is on, use /whitelist list instead.
Need a Minecraft server?
Try these commands on Astroworld or host your own server.
Try Astroworld Hosting