# 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)