> For the complete documentation index, see [llms.txt](https://docs.stopbot.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stopbot.net/v2/settings-guides/whitelist.md).

# Whitelist

Whitelist rules are intended for trusted sources such as your own server, office network, monitoring service, partner network, or another known visitor source that should not be blocked by custom rules.

### Whitelist Menu

| Page                                                                                 | Use It For                                                                      |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| [IP Address](https://docs.stopbot.net/v2/panel-guides/settings/whitelist/ip-address) | Allow a single IP address, wildcard IP pattern, IP range, or CIDR-style network |
| [Hostname](https://docs.stopbot.net/v2/panel-guides/settings/whitelist/hostname)     | Allow a specific hostname or wildcard hostname pattern                          |

### When To Use Each Rule

| Situation                                       | Recommended Rule                   |
| ----------------------------------------------- | ---------------------------------- |
| Your own server or office has a fixed public IP | IP Address, SINGLE IP              |
| A trusted network uses a known IP range         | IP Address, IP RANGES or LENGTH IP |
| A monitoring provider uses a known hostname     | Hostname, SINGLE or WILDCARD       |
| A trusted partner has stable reverse DNS        | Hostname, SINGLE                   |

### Add A Whitelist Rule

1. Open Settings > Whitelist.
2. Choose IP Address or Hostname.
3. Select the rule type.
4. Enter the trusted value.
5. Click Add.
6. Confirm the new entry appears in the list.
7. Test the protected service and review logs.

### Best Practices

* Only whitelist traffic you trust.
* Prefer exact IP addresses or exact hostnames when possible.
* Avoid broad wildcard or range rules unless the whole range is trusted.
* Review whitelist entries regularly.
* Remove old entries when a server, office network, or provider changes.

### Related Pages

| Page                                                                       | Purpose                              |
| -------------------------------------------------------------------------- | ------------------------------------ |
| [Settings Guide](https://docs.stopbot.net/v2/panel-guides/settings)        | Return to the Settings overview      |
| [Blacklist](https://docs.stopbot.net/v2/panel-guides/settings/blacklist)   | Manage custom deny rules             |
| [Blocker](https://docs.stopbot.net/v2/panel-guides/services/blocker)       | Review standard traffic decisions    |
| [Blocker V2](https://docs.stopbot.net/v2/panel-guides/services/blocker-v2) | Review advanced protection decisions |