Skip to content

Valheim: Whitelist

Learn how to set up a whitelist in Player Management for your Valheim server and allow only selected players → Find out more

19 November 20262 min read5 Views0 helpful

Don't have your own server yet? Host your Valheim server with ZAP-Hosting.

Introduction

A whitelist lets you control who can join your Valheim game server. As soon as at least one player is on the whitelist, the server only lets the listed players in—all others are blocked. This keeps your world private for you and your friends.

How the whitelist works

Valheim manages the allowed players in the permittedlist.txt file. Each entry is a Platform User ID in the format [platform]_[ID], for example Steam_76561198000000000 for Steam players. The server won’t recognize a number without a platform prefix.

You don’t need to edit the file manually: in ZapX, you can easily manage the whitelist in the dashboard. ZapX automatically adds the appropriate prefix and writes the list to the file when the server starts.

Warning

If even one player is on the whitelist, everyone else will be unable to connect. So always add yourself first.

Find a player ID

You need the ID of every player you want to allow:

  • In-game: Press F2 while on a server. The window shows the connected players and their IDs.
  • Steam profile: You can find the SteamID64 (17-digit number), for example, using the Steam ID Finder. Enter your Steam profile URL there and copy the "Steam64ID (Dec)".

The dashboard accepts a SteamID64 (17 digits), an Xbox XUID (16 digits) for Xbox and Microsoft Store players, or an ID already in the format Steam_<ID> or Xbox_<ID>.

Add players to the whitelist

  1. In your game server’s dashboard, open the Configuration tab.
  2. Scroll to the Player Management section.
  3. Enter the player’s ID in the search field.
  4. Open the new entry and check Whitelist. The change is saved immediately.
  5. Repeat this for every player you want to allow on your server.
  6. Restart your server—changes to Player Management only take effect after the next server restart.
Tip

You can also grant admin privileges in Player Management (check Admin) and ban players (check Banned). Learn more about admin commands in Valheim: Server Admin Commands & Cheats.

Remove players from the whitelist

Find the player in Player Management, open their entry, and uncheck Whitelist. They will no longer be able to connect after the next server restart.

Important

If you remove all players from the whitelist, the last saved permittedlist.txt file remains unchanged when the server starts—the whitelist will still be active. To disable the whitelist completely, stop the server, open permittedlist.txt in the Files tab, and delete all lines containing player IDs (you can leave the comment line starting with //), then save the file and restart the server.

Check the whitelist

After restarting, try connecting with an account that isn’t on the whitelist—the connection should be rejected. An account on the list should be able to join the server as usual. If this doesn’t work, check that the server was restarted after your last change and that you entered the correct ID.

Conclusion

Your Valheim whitelist is now set up, and only the players you’ve allowed can join your server. If you have any other questions or need help, our support team is available every day! 🙂

FAQ

Frequently asked questions

In the Configuration tab, go to Player Management, enter a player’s ID, open the entry, and check Whitelist. Then restart the server.
Valheim expects a Platform User ID such as Steam_76561198000000000. In the dashboard, you can enter the SteamID64 or Xbox XUID, and ZapX will add the prefix automatically.
All other players will be unable to connect. So always add yourself first.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people 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.