New

EmeraldHost 2.0 is here: faster, more intuitive, and made for everyone - the new panel!

Learn more
Guides
How to Enable the Whitelist on a Hytale Server
HytaleHytaleEnable Whitelist

How to Enable the Whitelist on a Hytale Server

Enable whitelist on a Hytale server

2 min read
Jan 15, 2026

With the whitelist, you can control who can join your server. Only players on the whitelist can connect.

How to Enable the Whitelist

  1. Open dashboard
    Open the dashboard of your Hytale server.

  2. Enable the Whitelist
    Enter the following command in the console:

    whitelist enable
    

The server saves this setting in config.json right away ("RequireJoinPermission": true). So the whitelist stays active after a restart.

How to Add Players

whitelist add <playername>

Instead of the name, you can also use the player's UUID. The player does not have to be online for this.

How to Remove Players

whitelist remove <playername>

All Commands

Command Description
whitelist enable Enable the whitelist
whitelist disable Disable the whitelist
whitelist add <player> Add player to the whitelist
whitelist remove <player> Remove player from the whitelist
whitelist list Show all players on the whitelist
whitelist status Show whitelist status
whitelist clear Clear the whitelist

Where Does Hytale Store the Whitelist?

Since Update 6, there is no separate whitelist.json anymore. Instead, every player on the whitelist receives the permission hytale.server.join, which the server stores in permissions.json in the main directory. If you still have an old whitelist.json, the server takes it over automatically on startup and renames it to whitelist.json.migrated.

Written byEmeraldHost Team
Last updated on Sep 27, 2026 Edit on GitHub

Did this article help you?

Your feedback helps us improve our guides.

Help shape the guides

€10.00 in credit for every new guide, €5.00 for every improvement.

Contact Support

Create a support ticket and our team will get back to you as soon as possible – personal and professional.

Go to Support
1257 members online

Discord Community

Connect with other players, get quick help from the community, and stay up to date with the latest news.

Join Discord
Hytale

Ready to get started?

Rent your Hytale Server now

Join our Discord community 1257 members online right now