Skip to main content
  • Instant digital delivery
  • Lifetime updates on selected products
  • Trusted by server owners
FiveMX
Shop
Full ServersBundlesNew releases
FiveMX

Start building your server today.

Curated FiveM resources, instant delivery, free starter mods, and practical guides in one calm marketplace.

Browse the shopsupport@fivemx.com

Shop

  • Shop
  • FiveM Mods
  • All Products
  • Free Mods
  • Best Scripts & Mods
  • FiveM Scripts

Frameworks

  • QBCore Scripts
  • ESX Scripts
  • QBox
  • Standalone

Community

  • Blog
  • Support
  • Creators
  • Affiliate

Legal

  • Privacy Policy
  • Terms of Service
  • Refund Policy
  • Digital Delivery
  • Cookie Policy
  • GDPR Compliance
  • DMCA
  • Imprint
  • Editorial Policy

Server Templates

  • QBCore Server Template
  • ESX Server Template
  • NoPixel Server Template
  • Server Packs
  • Free Server Templates
  • Tebex Alternative
© 2026 FiveMX. All rights reserved.·FiveMX is not affiliated with Rockstar Games, Take-Two Interactive, or CFX.re. All trademarks are property of their respective owners.
DiscordDocs
  1. Home
  2. Blog
  3. Tutorials & Guides
Table of Contents
TL;DRThree Whitelist Approaches: Which One Fits Your Server?

How to Set Up a Discord Whitelist for Your FiveM Server (2026 Guide)

Published on August 17, 2025·by Lars Miller(Founder & Lead Editor)·Credentials·2 min read·Updated on May 18, 2026
Tutorials & Guidesdiscord whitelist fivem

Gate access to your FiveM server with a Discord role-based whitelist. Covers three implementation approaches (pure Discord, identifier-based, hybrid), step-by-step bot setup, working QBCore and ESX examples, common mistakes that break auth, and security hardening.

Share
How to Set Up a Discord Whitelist for Your FiveM Server (2026 Guide)
How to Set Up a Discord Whitelist for Your FiveM Server (2026 Guide)

A Discord whitelist gates access to your FiveM server using Discord roles. Players without the right role can't join, moderators can grant or revoke access from their phone via a role toggle, and every grant is logged in Discord's audit trail.

This guide covers three implementation approaches, step-by-step bot setup, working configurations for both QBCore and ESX, common mistakes that silently break auth, and security hardening for production servers.

Note on versions: The open-source FAXES/DiscordWhitelist repo is community-maintained and last updated in 2022. It still works for most servers. Several commercial forks exist with active maintenance and SLA support. This guide covers the free GitHub version and the patterns apply to any Discord-based whitelist.

TL;DR

FiveM Discord Whitelist System Setup

  1. Create a Discord Bot in the Developer Portal → enable Server Members Intent → invite to your guild.
  2. Copy your Guild (Server) ID and Role ID(s).
  3. Download FAXES/DiscordWhitelist into resources/ and configure server.js.
  4. Add ensure DiscordWhitelist to server.cfg.
  5. Test: join without the role (blocked), grant the role, rejoin (allowed).

Three Whitelist Approaches: Which One Fits Your Server?

Before picking an implementation, decide which of these three approaches matches your operational reality:

| Approach | How it works | Pros | Cons | Best for | |

Frequently Asked Questions

Why use Discord for whitelisting a FiveM server?

Discord whitelisting is dynamic (grant access by adding a role, no ACE or DB edits), scalable (moderators can manage access from mobile Discord), and auditable (Discord role history + audit logs show who granted what). The main trade-off vs identifier-based whitelisting is that players must have the Discord desktop app running when connecting, which makes Discord the hard dependency for joining your server.

Which whitelist approach should I pick: pure Discord, identifier-based, or hybrid?

Pure Discord role check is simplest and best for servers under 500 concurrent players — one Discord role controls everything. Identifier-based (SQL table of allowed Steam/license IDs) is most secure and independent of Discord, at the cost of manual list management. Hybrid combines both: Discord role for most players, identifier whitelist as break-glass for VIPs/admins when Discord API is down. Hybrid is the right answer for serious servers.

What do I need to set up a Discord whitelist?

Four things: (1) a Discord server where you're admin, (2) a FiveM server with txAdmin or CLI access, (3) players running the Discord desktop app before launching FiveM (so FiveM exposes the discord: identifier), and (4) a bot created in the Discord Developer Portal with the Server Members Intent enabled.

How do I fix the 'Bot offline' error?

Three causes: wrong bot token in config, bot not actually invited to the guild, or the Server Members Intent wasn't enabled in the Developer Portal. Verify the token starts with the correct prefix, check that the bot appears in your Discord member list (offline is fine, not-present is not), and confirm both Intents in the Bot tab of the Developer Portal: Server Members Intent ON, Presence Intent can stay OFF.

Table of Contents

TL;DRThree Whitelist Approaches: Which One Fits Your Server?

More on This Topic

Turn framework research into a launch-ready script stack

Use this guide to narrow the framework decision, then move into the core commercial hubs for verified scripts, curated bundles, and a faster server launch path.

QBCore starter

Use a complete QBCore base when the guide points to a new server launch and you want jobs, economy, UI, and admin tooling already connected.

View QBCore template

ESX starter

Compare a full ESX server pack when you need a faster path from setup research to a working roleplay stack.

View ESX server pack

Complete server path

If the article is part of a launch plan, start with full server packs that reduce setup time and connect multiple systems faster.

Open full server packs

Disclosure: Some links below are affiliate links to FiveMX products. We may earn a commission at no extra cost to you.

Premium Scripts You Might Like

Free Scripts You Might Like

Related Articles

Learn how to optimize FiveM server loading times by managing resources, using efficient mods, and choosing the right server host to eliminate annoying delays.

September 3, 2024

Want to boost your FiveM server population? Let's get you there! So, you've got your FiveM server up and running, that's awesome! But now you're wondering...

March 24, 2025

Running txAdmin without Discord integration means your community has no way to see server status, scheduled restarts, or player counts without launching the game.

August 17, 2025
Players are blocked even when they have the whitelist role. What's wrong?

The most common cause is the Discord desktop app not running when the player launches FiveM — without it, FiveM can't expose a discord: identifier to the script. Have the player restart Discord, wait for it to fully load, then launch FiveM. If that doesn't fix it, the bot's guild-members cache is stale — reduce cacheMaxTime in the config from 90s to 30s.

Can I use multiple whitelist roles (Donator, Staff, Applied)?

Yes. Add every role ID to the whitelistRoles array in the config. Access is granted if the player has any one of the listed roles. This is how most servers handle funnel differentiation — one role for approved applicants, another for donators, a third for staff with automatic access.

How do I prevent race conditions where role changes take minutes to apply?

Two things: lower cacheMaxTime to 30-60 seconds so the bot refreshes role data more often, and if you need instant updates, implement a webhook on the Discord role-change event that invalidates the cache immediately. Without the webhook, players who just received a role will be denied until the next cache refresh — annoying but usually not worth the implementation effort unless you have high applicant churn.

Is Discord whitelisting secure against bypass attempts?

The weak link is the bot token. If it leaks, attackers can impersonate the bot, read your guild member list, and potentially inject themselves into the whitelist. Store the token outside version control (env var or convar), rotate if leaked, and restrict who has write access to the resource folder. For high-value servers, pair Discord whitelisting with an identifier-based fallback — that way even a complete Discord compromise doesn't grant server access.

Launch faster

Compare curated bundles

Bundles shorten the path from planning to launch by grouping the highest-leverage scripts into a cleaner commercial starting point.

View bundles
Previous Article

How to Evaluate, Test, and Maintain FiveM Scripts

Next Article

How to Connect txAdmin to Discord (2026 Guide)

How to Set Up a FiveM GTA RP Server (2026) — Complete Step-by-Step Guide
How to Install a FiveM Server Template (2026) — Step-by-Step Guide
FiveM Full Server Download: Complete Server Packs Explained (2026)
How to Run a FiveM Server Using Docker: Complete Setup Guide
FiveM Server Management: The Complete Guide from Setup to Scale
Start from a QBCore full server
Review the Super ESX Server pack
Compare full server packs
ADN’s Whitelist System

ADN’s Whitelist System

$11.49
Password Whitelist Script

Password Whitelist Script

$7.49
Active Duty Officer — Active Officer Display & Access Control

Active Duty Officer — Active Officer Display & Access Control

$13.00
Infinity Server (Dutch)

Infinity Server (Dutch)

$109.99
Gameconfig for Legacy & Enhanced

Gameconfig for Legacy & Enhanced

8,243,364 downloads
PC Trainer V

PC Trainer V

1,272,946 downloads
LemonUI: Open Source UI Library

LemonUI: Open Source UI Library

1,138,096 downloads
NFS gauge - RPM Gear Speedometer & Timer

NFS gauge - RPM Gear Speedometer & Timer

1,058,515 downloads
Eliminate Annoying Delays: Optimize FiveM Server Loading ...
Eliminate Annoying Delays: Optimize FiveM Server Loading ...
How To Grow your FiveM Server Player Base
How To Grow your FiveM Server Player Base
How to Connect txAdmin to Discord (2026 Guide)
How to Connect txAdmin to Discord (2026 Guide)

No time to configure everything yourself?

Start with a pre-built, tested FiveM server pack. Framework-optimized, all scripts pre-installed.

Super ESX Server
esxstandalone

Super ESX Server

The Super ESX Server is one of the best FiveM server templates - over 1.000 purchases! Want to know why we call it our Super Server? Check out our video to find out some of the basics details of the world. Update 10 is included, make sure to install v7 first and then use content of v10 yo

$228.32
ESX Server Base (by RibSosay)
esxstandalone

ESX Server Base (by RibSosay)

Prebuilt FiveM server with ESX framework GUARANTEE : We offer a guarantee ensuring compatibility with your setup.

$53.99
View all server packs