> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin menu

> The admin menu is where you add and remove whitelist entries. Open it with /whitelistmenu and changes take effect immediately — no restart needed.

The admin menu is where you add and remove whitelist entries. Open it with `/whitelistmenu` and changes take effect immediately — no restart needed.

## Opening the menu

```
/whitelistmenu
```

You need the `Config.AdminGroup` ACE group (default `group.admin`):

```
add_ace identifier.steam:XXXXXXXXX group.admin
```

You can also bind it to a key from **FiveM Settings → Key Bindings → FiveM** — `/whitelistmenu` registers itself as a keybindable command.

## Tabs

| Tab         | What it manages                                                 |
| ----------- | --------------------------------------------------------------- |
| **Items**   | Item names from your inventory data (e.g. `radio`, `lockpick`). |
| **Weapons** | Weapon hash names (e.g. `WEAPON_PISTOL`). Auto-uppercased.      |

## Adding an entry

1. Pick the tab — **Items** or **Weapons**.

2. Click **Add**.

3. Type the item or weapon name (e.g. `radio` or `WEAPON_PISTOL`).

4. Pick a **scope**:

   | Scope      | Picker input                                                                    | What it does                                                                                         |
   | ---------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
   | **Job**    | Job name (e.g. `police`)                                                        | Only members of that job can have / trade / use the item.                                            |
   | **Player** | **Server ID** or **identifier** (citizenid for QBox/QBCore, identifier for ESX) | Only that player can have / trade / use it. Server IDs are resolved to the identifier automatically. |

5. Click **Save**.

## Stacking scopes

You can add multiple entries for the same item. Their access is **additive** — a player passes the whitelist if **any** of the entries match them.

Common patterns:

* `radio` + `job=police` + `job=sheriff` — both jobs can have it.
* `radio` + `job=police` + `identifier=ABC123` — police can have it, plus one specific player (e.g. the chief) regardless of job.
* `WEAPON_HEAVYRIFLE` + `identifier=ABC123` — single-player soulbound.

## Removing an entry

The menu lists every entry on its tab with its scope. Click the trash icon next to the specific scope to remove it. The item stays whitelisted as long as any other scope remains; remove all scopes and the item is no longer whitelisted at all.

## Searching

Each tab has a search box at the top. Type any part of the item name to filter.
