# Whitelist Overview

> Whitelist allows trusted users, roles, and channels to bypass Security's protection limits.

## What Is Whitelisting?

Whitelisting exempts specific entities from Anti-Nuke monitoring. Whitelisted users and roles can perform actions without triggering punishments, even if they exceed the configured limits.

## Whitelist Types

| Type                  | Description                          | Use Case                    |
| --------------------- | ------------------------------------ | --------------------------- |
| **User Whitelist**    | Exempts specific members             | Trusted administrators      |
| **Role Whitelist**    | Exempts all members with a role      | Admin/mod teams             |
| **Channel Whitelist** | Exempts actions in specific channels | Bot channels, spam channels |

## Whitelist Categories

You can whitelist for specific actions or globally:

| Category                  | What It Bypasses       |
| ------------------------- | ---------------------- |
| **Global**                | All Anti-Nuke actions  |
| **Ban**                   | Ban limit only         |
| **Kick**                  | Kick limit only        |
| **Channel Delete**        | Channel deletion limit |
| **Channel Create**        | Channel creation limit |
| **Role Delete**           | Role deletion limit    |
| **Role Create**           | Role creation limit    |
| **Bot Add**               | Bot addition limit     |
| **Dangerous Permissions** | Permission grant limit |
| **Dangerous Roles**       | Role assignment limit  |

## Quick Reference

| Task                      | Command                     |
| ------------------------- | --------------------------- |
| View whitelisted users    | `/whitelist view_users`     |
| View whitelisted roles    | `/whitelist view_roles`     |
| View whitelisted channels | `/whitelist view_channels`  |
| Add user                  | `/whitelist add_user`       |
| Remove user               | `/whitelist remove_user`    |
| Add role                  | `/whitelist add_role`       |
| Remove role               | `/whitelist remove_role`    |
| Add channel               | `/whitelist add_channel`    |
| Remove channel            | `/whitelist remove_channel` |

## Detailed Guides

* [User Whitelist](https://docs.securitybot.gg/whitelist/whitelist/user-whitelist) - Exempt specific users
* [Role Whitelist](https://docs.securitybot.gg/whitelist/whitelist/role-whitelist) - Exempt roles
* [Channel Whitelist](https://docs.securitybot.gg/whitelist/whitelist/channel-whitelist) - Exempt channels

## Best Practices

* **Use role whitelisting** over user whitelisting when possible (easier to manage)
* **Whitelist for specific actions** rather than globally when feasible
* **Regularly audit** your whitelist to remove former staff
* **Document** why each entry is whitelisted

## Related

* [Anti-Nuke](https://docs.securitybot.gg/anti-nuke/anti-nuke) - Protection system that whitelists bypass
* [Beast Mode](https://docs.securitybot.gg/other-modules/beast-mode) - Global protection (has separate whitelist option)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.securitybot.gg/whitelist/whitelist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.