{"id":4642,"date":"2026-05-13T14:14:45","date_gmt":"2026-05-13T14:14:45","guid":{"rendered":"https:\/\/www.g-portal.com\/wiki\/?p=4642"},"modified":"2026-05-13T14:14:46","modified_gmt":"2026-05-13T14:14:46","slug":"minecraft-server-set-up-whitelist","status":"publish","type":"post","link":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/","title":{"rendered":"Minecraft Whitelist: Setup &amp; More"},"content":{"rendered":"\n<p>A Minecraft server is only as private as its whitelist. Without one, anyone with the IP can drop in; with one, only the players you name can join. The mechanism itself has been part of Java Edition since the very early multiplayer builds, but how you actually manage it (through the <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-guide\/\">server<\/a> panel, with in-game <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-commands\/\">commands<\/a>, or by editing config files directly) is where most setups go wrong.<\/p>\n\n\n\n<div class='hint hint--brand'><p><strong>Quick Solution:<\/strong><\/p>\n\n\n\n<ol>\n<li>In <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/default-configuration-of-a-minecraft-server\/\"><em>server.properties<\/em><\/a>, set <em>white-list=true<\/em> (or toggle <em>Whitelist<\/em> on in the GPORTAL panel).<\/li>\n\n\n\n<li>Add players in-game with <em>\/whitelist<\/em> add <em>&lt;playername><\/em>. The server resolves the name to a UUID automatically.<\/li>\n\n\n\n<li>Optionally, set <em>enforce-whitelist=true<\/em> to kick non-whitelisted players the moment the list changes.<\/li>\n<\/ol>\n\n\n\n<p>Bedrock Edition uses <em>allowlist.json<\/em> instead of <em>whitelist.json<\/em>, but the workflow is identical.<\/p><\/div>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"GPORTAL Minecraft Server \u2013 How to set up a whitelist\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/g2F87XNiSMs?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">What Is A Whitelist in Minecraft?<\/h2>\n\n\n\n<p>A Minecraft whitelist is a server-side list of player accounts that are allowed to connect. When the whitelist is active, the server checks every incoming connection against that list: known players come straight in, everyone else is rejected with the message <em>\u2018You are not whitelisted on this server.\u2019<\/em> It is the simplest, most reliable way to keep a private <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-multiplayer\/\">multiplayer<\/a> server private: no <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-install-plugins\/\">plugins<\/a>, no permissions juggling, no proxy in front.<\/p>\n\n\n\n<p>The whitelist itself is stored in a file called <em>whitelist.json<\/em> on Java Edition (or <em>allowlist.json<\/em> on Bedrock), sitting alongside <em>server.properties<\/em> in the server&#8217;s root directory. Each entry pairs a player name with a UUID (the unique, never-changing ID Mojang assigns to every account) so a player can rename themselves without falling off the list. Players with <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\">OP<\/a> rights are exempt from the Minecraft whitelist check by default, which is worth knowing before you lock yourself out of your own server.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to Set Up A Whitelist on A Minecraft Server<\/h2>\n\n\n\n<p>There are three ways to manage a whitelist, and they all write to the same <em>whitelist.json<\/em> file under the hood. The right one to use depends on whether you are hosting through a panel like GPORTAL, sitting in-game as an operator, or editing files on a self-hosted box. Below, each path covers the full setup \u2013 enabling the whitelist, adding players, and reloading.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">GPORTAL Web Interface (Recommended)<\/h3>\n\n\n\n<p>On a <a href=\"https:\/\/www.g-portal.com\/en\/gameserver\/minecraft-server-hosting\">hosted GPORTAL Minecraft server<\/a>, the entire whitelist is managed from a single page. No SSH, no file editor and no commands are required:<\/p>\n\n\n\n<ol>\n<li>Log in at <a href=\"http:\/\/g-portal.com\">g-portal.com<\/a> and open <em>My Server.<\/em><\/li>\n\n\n\n<li>Select the relevant server, then click <em>Basic Settings.<\/em><\/li>\n\n\n\n<li>Activate the <em>Whitelist<\/em> option.<\/li>\n\n\n\n<li>Enter each player&#8217;s name (one per line) under the <em>Whitelist<\/em> field.<\/li>\n\n\n\n<li>Save changes and restart the server<\/li>\n<\/ol>\n\n\n\n<div class='hint hint--brand'><p><strong>Note:<\/strong>Players with <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\">OP<\/a> rights are automatically treated as whitelisted, so admins do not need to be added separately. They will, however, still appear in the panel&#8217;s whitelist field once the OP list is read.<\/p><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Minecraft Whitelist Commands<\/h3>\n\n\n\n<p>If you are already in-game as an operator, the Minecraft whitelist <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-commands\/\">commands<\/a> are the fastest way to enable the list and add players without touching any files. All commands work in single-player \u2018<em>Open to LAN\u2019<\/em> sessions with cheats enabled, in the <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-multiplayer\/\">multiplayer<\/a> chat as an OP, and in the server console:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">\/whitelist on          \u2192 enable whitelist<br><br>\/whitelist off         \u2192 disable whitelist<br><br>\/whitelist add &lt;name>  \u2192 add a player<br><br>\/whitelist remove &lt;name> \u2192 remove a player<br><br>\/whitelist list        \u2192 show all whitelisted players<br><br>\/whitelist reload      \u2192 re-read whitelist.json from disk<\/pre>\n\n\n\n<p>The <em>\/whitelist add<\/em> command is the part most older guides get wrong: since Java Edition 1.7.10, the server resolves the player&#8217;s name to a UUID automatically through Mojang&#8217;s API the moment you add them. You do not need to look up UUIDs by hand or paste them into JSON: the server handles all of it. The only time <em>\/whitelist reload<\/em> is needed is when you have manually edited <em>whitelist.json<\/em> outside the game and want the running server to pick up the changes without a restart.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Manual Configuration Via <em>server.properties<\/em> &amp; <em>whitelist.json<\/em><\/h3>\n\n\n\n<p>For self-hosted setups or any situation where the panel and the console are both unavailable, the whitelist can also be configured by editing two files directly. Stop the server before making changes, then:<\/p>\n\n\n\n<ol>\n<li>Open <em>server.properties<\/em> and change <em>white-list=false<\/em> to <em>white-list=true<\/em>.<\/li>\n\n\n\n<li>Open (or create) <em>whitelist.json<\/em> in the same directory and add each player as a JSON object containing their UUID and name:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-preformatted\">[<br><br>\u00a0\u00a0{<br><br>\u00a0\u00a0\u00a0\u00a0\"uuid\": \"069a79f4-44e9-4726-a5be-fca90e38aaf5\",<br><br>\u00a0\u00a0\u00a0\u00a0\"name\": \"Notch\"<br><br>\u00a0\u00a0},<br><br>\u00a0\u00a0{<br><br>\u00a0\u00a0\u00a0\u00a0\"uuid\": \"853c80ef-3c37-49fd-aa49-938b674adae6\",<br><br>\u00a0\u00a0\u00a0\u00a0\"name\": \"jeb_\"<br><br>\u00a0\u00a0}<br><br>]<\/pre>\n\n\n\n<p>UUIDs can be looked up through Mojang&#8217;s public API at:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><a href=\"https:\/\/api.mojang.com\/users\/profiles\/minecraft\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.mojang.com\/users\/profiles\/minecraft\/<\/a> &lt;username><\/pre>\n\n\n\n<p>Replace <em>&lt;username&gt;<\/em> with the player&#8217;s current Minecraft name and the response will contain their UUID. Once both files are saved, start the server. Going forward, you can stay in this manual workflow or switch to the in-game <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-admin-commands\/\">commands<\/a>. The formats are fully compatible.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Enforce Whitelist on Your Minecraft Server<\/h2>\n\n\n\n<p>Enabling the Minecraft whitelist only affects <em>new<\/em> connections. Anyone already on the server when you turn it on, or anyone who was on the list and then got removed, stays connected until they disconnect on their own. The <em>enforce-whitelist<\/em> setting in <em>server.properties<\/em> changes that behaviour: with it enabled, the server immediately kicks every player who is no longer on the whitelist the moment the list is reloaded.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">enforce-whitelist=true<\/pre>\n\n\n\n<p>This setting was added in Java Edition 1.17 and is off by default. You will mostly want it enabled on production servers where the whitelist is your only access control. Otherwise removing a problem player has no effect until they happen to log out. On a GPORTAL server, the same option is exposed in <em>Basic Settings<\/em> as a separate checkbox. You do not need to edit <em>server.properties<\/em> by hand. After flipping the setting, run <em>\/whitelist reload<\/em> in the console (or restart the server) for it to take effect.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><em>&#8216;You Are Not Whitelisted on This Server\u2019<\/em> \u2013 What It Means<\/h2>\n\n\n\n<p>If a player tries to join a whitelisted server without being on the list, the connection is closed instantly and the client shows <em>\u2018You are not whitelisted on this server\u2019<\/em> in red. The error is not a bug, a version mismatch or a network issue: it is the whitelist doing exactly what it was set up to do. There are three things to check, in order, when this comes up:<\/p>\n\n\n\n<ul>\n<li>the exact spelling of the player name in<em> <\/em><em>whitelist.json<\/em> or the panel field: case usually does not matter, but typos do<\/li>\n\n\n\n<li>whether the player recently changed their Minecraft username: if you added them by name before 1.7.10-style UUID resolution kicked in, the old name is stuck on the list<\/li>\n\n\n\n<li>whether the server is actually using the Minecraft whitelist you edited: on a multi-instance setup, it is easy to update the wrong server&#8217;s file<\/li>\n<\/ul>\n\n\n\n<p>If you are the server admin and you locked yourself out, <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\">OP rights<\/a> override the whitelist check, so connecting via the console or RCON to grant yourself OP first is the fastest fix. For broader join issues that look like a whitelist problem but are not (<a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-connection-timed-out\/\">connection refused<\/a>, timeouts, version mismatches) the dedicated troubleshooting article covers the network side.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">FAQ<\/h2>\n\n\n\n<div class=\"schema-faq wp-block-yoast-faq-block\"><div class=\"schema-faq-section\" id=\"faq-question-1778681331049\"><strong class=\"schema-faq-question\"><strong>How do I enable a whitelist on a Minecraft server?<\/strong><\/strong> <p class=\"schema-faq-answer\">Set <em>white-list=true<\/em> in <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/default-configuration-of-a-minecraft-server\/\"><em>server.properties<\/em><\/a> and restart the server, or toggle the <em>Whitelist<\/em> option in your hosting panel. On a GPORTAL server, this is a single checkbox in <em>Basic Settings<\/em>. Once enabled, add players with<em> \/whitelist add &lt;name><\/em>.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1778681606893\"><strong class=\"schema-faq-question\"><strong>What is the command to whitelist a player in Minecraft?<\/strong><\/strong> <p class=\"schema-faq-answer\">The <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-commands\/\">command<\/a> is <em>\/whitelist add &lt;playername><\/em>, run from the server console or by an OP in chat. The server automatically looks up the player&#8217;s UUID, so you only need the current Minecraft name. To remove someone, use <em>\/whitelist remove &lt;playername><\/em>.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1778681614719\"><strong class=\"schema-faq-question\"><strong>What is the difference between whitelist and <em>enforce-whitelist<\/em>?<\/strong><\/strong> <p class=\"schema-faq-answer\">The whitelist controls who can connect;<em> enforce-whitelist<\/em> controls what happens to players who are already connected when the list changes. With enforce off (default), removed players stay until they log out. With it on, they are kicked the moment the list is reloaded.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1778681626253\"><strong class=\"schema-faq-question\"><strong>Does the whitelist work on Bedrock Edition?<\/strong><\/strong> <p class=\"schema-faq-answer\">Yes, Bedrock uses a file called <em>allowlist.json<\/em> instead of <em>whitelist.json<\/em>, but the concept is identical and the in-game commands are the same. On a GPORTAL Bedrock server, the panel exposes the equivalent toggle in the same place.<\/p> <\/div> <div class=\"schema-faq-section\" id=\"faq-question-1778681639373\"><strong class=\"schema-faq-question\"><strong>How do I fix <em>\u2018You are not whitelisted on this server\u2019<\/em>?<\/strong><\/strong> <p class=\"schema-faq-answer\">If you are the player: ask the server owner to run<em> \/whitelist add &lt;your-current-name><\/em>. If you are the owner and locked out: connect via the server console or panel. <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\">OP rights<\/a> override the whitelist by default, so granting yourself OP before connecting solves it.<\/p> <\/div> <\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Whitelist Done: Now, Let the Right People In<\/h2>\n\n\n\n<p>A whitelist is one of those settings that takes thirty seconds to flip on and quietly does its job for the rest of the server&#8217;s lifetime. Combine it with OP rights for trusted admins and <em>enforce-whitelist=true<\/em> for quick removals, and you have a clean, dependable access model without a single <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-install-plugins\/\">plugin<\/a> in the way. For the bigger picture, e.g. <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/create-backups\/\">backups<\/a>, performance tuning, version management, our <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-guide\/\">server guide<\/a> covers what comes after the lock is on the door. Still, the easiest solution is a <a href=\"https:\/\/www.g-portal.com\/en\/gameserver\/minecraft-server-hosting\">GPORTAL-hosted Minecraft server<\/a> for you and your friends. Nothing will stop you there!<\/p>\n\n\n\n<div class=\"wp-block-button button-margin-top\"><a class=\"wp-block-button__link has-text-color has-background\" href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft\/\" style=\"background-color:#50fcea;color:#1e1e1e;border-radius:5px\"><strong>MORE ABOUT MINECRAFT<\/strong><\/a><\/div>\n","protected":false},"excerpt":{"rendered":"<p>A Minecraft server is only as private as its whitelist. Without one, anyone with the IP can drop in; with one, only the players you name can join. The mechanism itself has been part of Java Edition since the very early multiplayer builds, but how you actually manage it (through the server panel, with in-game commands, or by editing config files directly) is where most setups go wrong. What Is A Whitelist in Minecraft? A Minecraft whitelist is a server-side list of player accounts that are allowed to connect. When the whitelist is active, the server checks every incoming connection against that list: known players come straight in, everyone else is rejected with the message \u2018You are not whitelisted on this server.\u2019 It is the simplest, most reliable way to keep a private multiplayer server private: no plugins, no permissions juggling, no proxy in front. The whitelist itself is stored in a file called whitelist.json on Java Edition (or allowlist.json on Bedrock), sitting alongside server.properties in the server&#8217;s root directory. Each entry pairs a player name with a UUID (the unique, never-changing ID Mojang assigns to every account) so a player can rename themselves without falling off the list. Players with OP rights are exempt from the Minecraft whitelist check by default, which is worth knowing before you lock yourself out of your own server. How to Set Up A Whitelist on A Minecraft Server There are three ways to manage a whitelist, and they all write to the same whitelist.json file under the hood. The right one to use depends on whether you are hosting through a panel like GPORTAL, sitting in-game as an operator, or editing files on a self-hosted box. Below, each path covers the full setup \u2013 enabling the whitelist, adding players, and reloading. GPORTAL Web Interface (Recommended) On a hosted GPORTAL Minecraft server, the entire whitelist is managed from a single page. No SSH, no file editor and no commands are required: Minecraft Whitelist Commands If you are already in-game as an operator, the Minecraft whitelist commands are the fastest way to enable the list and add players without touching any files. All commands work in single-player \u2018Open to LAN\u2019 sessions with cheats enabled, in the multiplayer chat as an OP, and in the server console: \/whitelist on \u2192 enable whitelist\/whitelist off \u2192 disable whitelist\/whitelist add &lt;name> \u2192 add a player\/whitelist remove &lt;name> \u2192 remove a player\/whitelist list \u2192 show all whitelisted players\/whitelist reload \u2192 re-read whitelist.json from disk The \/whitelist add command is the part most older guides get wrong: since Java Edition 1.7.10, the server resolves the player&#8217;s name to a UUID automatically through Mojang&#8217;s API the moment you add them. You do not need to look up UUIDs by hand or paste them into JSON: the server handles all of it. The only time \/whitelist reload is needed is when you have manually edited whitelist.json outside the game and want the running server to pick up the changes without a restart. Manual Configuration Via server.properties &amp; whitelist.json For self-hosted setups or any situation where the panel and the console are both unavailable, the whitelist can also be configured by editing two files directly. Stop the server before making changes, then: [\u00a0\u00a0{\u00a0\u00a0\u00a0\u00a0&#8220;uuid&#8221;: &#8220;069a79f4-44e9-4726-a5be-fca90e38aaf5&#8221;,\u00a0\u00a0\u00a0\u00a0&#8220;name&#8221;: &#8220;Notch&#8221;\u00a0\u00a0},\u00a0\u00a0{\u00a0\u00a0\u00a0\u00a0&#8220;uuid&#8221;: &#8220;853c80ef-3c37-49fd-aa49-938b674adae6&#8221;,\u00a0\u00a0\u00a0\u00a0&#8220;name&#8221;: &#8220;jeb_&#8221;\u00a0\u00a0}] UUIDs can be looked up through Mojang&#8217;s public API at: https:\/\/api.mojang.com\/users\/profiles\/minecraft\/ &lt;username> Replace &lt;username&gt; with the player&#8217;s current Minecraft name and the response will contain their UUID. Once both files are saved, start the server. Going forward, you can stay in this manual workflow or switch to the in-game commands. The formats are fully compatible. Enforce Whitelist on Your Minecraft Server Enabling the Minecraft whitelist only affects new connections. Anyone already on the server when you turn it on, or anyone who was on the list and then got removed, stays connected until they disconnect on their own. The enforce-whitelist setting in server.properties changes that behaviour: with it enabled, the server immediately kicks every player who is no longer on the whitelist the moment the list is reloaded. enforce-whitelist=true This setting was added in Java Edition 1.17 and is off by default. You will mostly want it enabled on production servers where the whitelist is your only access control. Otherwise removing a problem player has no effect until they happen to log out. On a GPORTAL server, the same option is exposed in Basic Settings as a separate checkbox. You do not need to edit server.properties by hand. After flipping the setting, run \/whitelist reload in the console (or restart the server) for it to take effect. &#8216;You Are Not Whitelisted on This Server\u2019 \u2013 What It Means If a player tries to join a whitelisted server without being on the list, the connection is closed instantly and the client shows \u2018You are not whitelisted on this server\u2019 in red. The error is not a bug, a version mismatch or a network issue: it is the whitelist doing exactly what it was set up to do. There are three things to check, in order, when this comes up: If you are the server admin and you locked yourself out, OP rights override the whitelist check, so connecting via the console or RCON to grant yourself OP first is the fastest fix. For broader join issues that look like a whitelist problem but are not (connection refused, timeouts, version mismatches) the dedicated troubleshooting article covers the network side. FAQ Whitelist Done: Now, Let the Right People In A whitelist is one of those settings that takes thirty seconds to flip on and quietly does its job for the rest of the server&#8217;s lifetime. Combine it with OP rights for trusted admins and enforce-whitelist=true for quick removals, and you have a clean, dependable access model without a single plugin in the way. For the bigger picture, e.g. backups, performance tuning, version management, our server guide covers what comes after the lock is on the door. Still, the easiest solution is a GPORTAL-hosted Minecraft server for you and your friends. Nothing will stop you there!<\/p>\n","protected":false},"author":6,"featured_media":11963,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"post-blog-template.php","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[30,22],"tags":[],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.9 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Minecraft Whitelist: Setup, Command &amp; Enforce | GPORTAL<\/title>\n<meta name=\"description\" content=\"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Minecraft Whitelist: Setup, Command &amp; Enforce | GPORTAL\" \/>\n<meta property=\"og:description\" content=\"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/\" \/>\n<meta property=\"og:site_name\" content=\"GPORTAL Wiki\" \/>\n<meta property=\"article:published_time\" content=\"2026-05-13T14:14:45+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-13T14:14:46+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png\" \/>\n\t<meta property=\"og:image:width\" content=\"28\" \/>\n\t<meta property=\"og:image:height\" content=\"23\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"David Martin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"David Martin\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"WebPage\",\"FAQPage\"],\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/\",\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/\",\"name\":\"Minecraft Whitelist: Setup, Command & Enforce | GPORTAL\",\"isPartOf\":{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png\",\"datePublished\":\"2026-05-13T14:14:45+00:00\",\"dateModified\":\"2026-05-13T14:14:46+00:00\",\"author\":{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/58b2d6a505f9d534cd1400d66c526728\"},\"description\":\"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#breadcrumb\"},\"mainEntity\":[{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049\"},{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893\"},{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719\"},{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253\"},{\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373\"}],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage\",\"url\":\"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png\",\"contentUrl\":\"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png\",\"width\":28,\"height\":23},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.g-portal.com\/wiki\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Minecraft Whitelist: Setup &amp; More\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/#website\",\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/\",\"name\":\"GPORTAL Wiki\",\"description\":\"GPORTAL Wiki\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.g-portal.com\/wiki\/en\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/58b2d6a505f9d534cd1400d66c526728\",\"name\":\"David Martin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/501478c8264287235ed4eab002807fbb?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/501478c8264287235ed4eab002807fbb?s=96&d=mm&r=g\",\"caption\":\"David Martin\"},\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/author\/david\/\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049\",\"position\":1,\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049\",\"name\":\"How do I enable a whitelist on a Minecraft server?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"Set <em>white-list=true<\/em> in <a href=\\\"https:\/\/www.g-portal.com\/wiki\/en\/default-configuration-of-a-minecraft-server\/\\\"><em>server.properties<\/em><\/a> and restart the server, or toggle the <em>Whitelist<\/em> option in your hosting panel. On a GPORTAL server, this is a single checkbox in <em>Basic Settings<\/em>. Once enabled, add players with<em> \/whitelist add &lt;name><\/em>.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893\",\"position\":2,\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893\",\"name\":\"What is the command to whitelist a player in Minecraft?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"The <a href=\\\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-commands\/\\\">command<\/a> is <em>\/whitelist add &lt;playername><\/em>, run from the server console or by an OP in chat. The server automatically looks up the player's UUID, so you only need the current Minecraft name. To remove someone, use <em>\/whitelist remove &lt;playername><\/em>.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719\",\"position\":3,\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719\",\"name\":\"What is the difference between whitelist and enforce-whitelist?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"The whitelist controls who can connect;<em> enforce-whitelist<\/em> controls what happens to players who are already connected when the list changes. With enforce off (default), removed players stay until they log out. With it on, they are kicked the moment the list is reloaded.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253\",\"position\":4,\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253\",\"name\":\"Does the whitelist work on Bedrock Edition?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"Yes, Bedrock uses a file called <em>allowlist.json<\/em> instead of <em>whitelist.json<\/em>, but the concept is identical and the in-game commands are the same. On a GPORTAL Bedrock server, the panel exposes the equivalent toggle in the same place.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Question\",\"@id\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373\",\"position\":5,\"url\":\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373\",\"name\":\"How do I fix \u2018You are not whitelisted on this server\u2019?\",\"answerCount\":1,\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"If you are the player: ask the server owner to run<em> \/whitelist add &lt;your-current-name><\/em>. If you are the owner and locked out: connect via the server console or panel. <a href=\\\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\\\">OP rights<\/a> override the whitelist by default, so granting yourself OP before connecting solves it.\",\"inLanguage\":\"en-US\"},\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Minecraft Whitelist: Setup, Command & Enforce | GPORTAL","description":"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/","og_locale":"en_US","og_type":"article","og_title":"Minecraft Whitelist: Setup, Command & Enforce | GPORTAL","og_description":"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.","og_url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/","og_site_name":"GPORTAL Wiki","article_published_time":"2026-05-13T14:14:45+00:00","article_modified_time":"2026-05-13T14:14:46+00:00","og_image":[{"width":28,"height":23,"url":"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png","type":"image\/png"}],"author":"David Martin","twitter_card":"summary_large_image","twitter_misc":{"Written by":"David Martin","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["WebPage","FAQPage"],"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/","url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/","name":"Minecraft Whitelist: Setup, Command & Enforce | GPORTAL","isPartOf":{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage"},"image":{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage"},"thumbnailUrl":"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png","datePublished":"2026-05-13T14:14:45+00:00","dateModified":"2026-05-13T14:14:46+00:00","author":{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/58b2d6a505f9d534cd1400d66c526728"},"description":"How to set up a Minecraft whitelist on your server? \u2713GPORTAL panel \u2713\/whitelist commands \u2713server.properties config \u25baEverything here.","breadcrumb":{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#breadcrumb"},"mainEntity":[{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049"},{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893"},{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719"},{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253"},{"@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373"}],"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#primaryimage","url":"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png","contentUrl":"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png","width":28,"height":23},{"@type":"BreadcrumbList","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.g-portal.com\/wiki\/en\/"},{"@type":"ListItem","position":2,"name":"Minecraft Whitelist: Setup &amp; More"}]},{"@type":"WebSite","@id":"https:\/\/www.g-portal.com\/wiki\/en\/#website","url":"https:\/\/www.g-portal.com\/wiki\/en\/","name":"GPORTAL Wiki","description":"GPORTAL Wiki","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.g-portal.com\/wiki\/en\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/58b2d6a505f9d534cd1400d66c526728","name":"David Martin","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.g-portal.com\/wiki\/en\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/501478c8264287235ed4eab002807fbb?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/501478c8264287235ed4eab002807fbb?s=96&d=mm&r=g","caption":"David Martin"},"url":"https:\/\/www.g-portal.com\/wiki\/en\/author\/david\/"},{"@type":"Question","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049","position":1,"url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681331049","name":"How do I enable a whitelist on a Minecraft server?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Set <em>white-list=true<\/em> in <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/default-configuration-of-a-minecraft-server\/\"><em>server.properties<\/em><\/a> and restart the server, or toggle the <em>Whitelist<\/em> option in your hosting panel. On a GPORTAL server, this is a single checkbox in <em>Basic Settings<\/em>. Once enabled, add players with<em> \/whitelist add &lt;name><\/em>.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893","position":2,"url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681606893","name":"What is the command to whitelist a player in Minecraft?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"The <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-commands\/\">command<\/a> is <em>\/whitelist add &lt;playername><\/em>, run from the server console or by an OP in chat. The server automatically looks up the player's UUID, so you only need the current Minecraft name. To remove someone, use <em>\/whitelist remove &lt;playername><\/em>.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719","position":3,"url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681614719","name":"What is the difference between whitelist and enforce-whitelist?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"The whitelist controls who can connect;<em> enforce-whitelist<\/em> controls what happens to players who are already connected when the list changes. With enforce off (default), removed players stay until they log out. With it on, they are kicked the moment the list is reloaded.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253","position":4,"url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681626253","name":"Does the whitelist work on Bedrock Edition?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"Yes, Bedrock uses a file called <em>allowlist.json<\/em> instead of <em>whitelist.json<\/em>, but the concept is identical and the in-game commands are the same. On a GPORTAL Bedrock server, the panel exposes the equivalent toggle in the same place.","inLanguage":"en-US"},"inLanguage":"en-US"},{"@type":"Question","@id":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373","position":5,"url":"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-up-whitelist\/#faq-question-1778681639373","name":"How do I fix \u2018You are not whitelisted on this server\u2019?","answerCount":1,"acceptedAnswer":{"@type":"Answer","text":"If you are the player: ask the server owner to run<em> \/whitelist add &lt;your-current-name><\/em>. If you are the owner and locked out: connect via the server console or panel. <a href=\"https:\/\/www.g-portal.com\/wiki\/en\/minecraft-server-set-op-rights\/\">OP rights<\/a> override the whitelist by default, so granting yourself OP before connecting solves it.","inLanguage":"en-US"},"inLanguage":"en-US"}]}},"jetpack_featured_media_url":"https:\/\/www.g-portal.com\/wiki\/wp-content\/uploads\/2021\/05\/Whitelist.png","_links":{"self":[{"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/posts\/4642"}],"collection":[{"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/comments?post=4642"}],"version-history":[{"count":14,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/posts\/4642\/revisions"}],"predecessor-version":[{"id":28891,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/posts\/4642\/revisions\/28891"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/media\/11963"}],"wp:attachment":[{"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/media?parent=4642"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/categories?post=4642"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.g-portal.com\/wiki\/en\/wp-json\/wp\/v2\/tags?post=4642"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}