> 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/blacklist/ip-address.md).

# IP Address

Use Blacklist IP Address to block specific IP addresses, wildcard IP patterns, IP ranges, or CIDR-style ranges from your STOPBOT-protected services.

### Marked Screenshot

<figure><img src="/files/KNrELR6YMiAXNRa1hFuY" alt=""><figcaption></figcaption></figure>

| Marker | Control        | What It Does                                        |
| ------ | -------------- | --------------------------------------------------- |
| 1      | IP Address     | Enter one or more IP values.                        |
| 2      | Hostname       | Enter the hostname value.                           |
| 3      | Useragent      | Open or control this panel item.                    |
| 4      | Guide          | Open the related service guide.                     |
| 5      | IP Type        | Select single IP, wildcard, range, or CIDR type.    |
| 6      | IP Address     | Enter one or more IP values.                        |
| 7      | Add IP Address | Add the IP rule to the list.                        |
| 8      | Remove All     | Remove all records in this list after confirmation. |

### Add Blacklist IP

The Add Blacklist IP form includes:

| Field      | Description                                    |
| ---------- | ---------------------------------------------- |
| Type       | IP rule type                                   |
| IP Address | IP value, range, wildcard, or CIDR-style value |

### Supported Types And Examples

| Type        | Single Example               | Bulk Example                                             | Use It For                                              |
| ----------- | ---------------------------- | -------------------------------------------------------- | ------------------------------------------------------- |
| SINGLE IP   | `203.0.113.10`               | `203.0.113.10,203.0.113.11`                              | Blocking one or more exact IP addresses                 |
| WILDCARD IP | `203.0.113.*`                | `203.0.113.*,198.51.100.*`                               | Blocking repeated traffic from a predictable IP pattern |
| LENGTH IP   | `203.0.113.10-203.0.113.250` | `203.0.113.10-203.0.113.250,198.51.100.10-198.51.100.50` | Blocking an IP range with a start and end IP            |
| IP RANGES   | `203.0.113.0/24`             | `203.0.113.0/24,198.51.100.0/24`                         | Blocking a CIDR-style network                           |

The panel also supports multi-entry input for bulk submission, with comma-separated values.

### Example Scenarios

| Scenario                                | Type        | Value Example                |
| --------------------------------------- | ----------- | ---------------------------- |
| Block one abusive IP                    | SINGLE IP   | `203.0.113.10`               |
| Block two known abusive IPs at once     | SINGLE IP   | `203.0.113.10,203.0.113.11`  |
| Block a repeated subnet pattern         | WILDCARD IP | `203.0.113.*`                |
| Block a specific start-to-end range     | LENGTH IP   | `203.0.113.10-203.0.113.250` |
| Block an entire documented test network | IP RANGES   | `203.0.113.0/24`             |

### How To Add

1. Open Settings > Blacklist > IP Address.
2. Select the rule type.
3. Enter the IP value.
4. Click Add.
5. Check the Blacklist IP List to confirm the entry was created.

### Blacklist IP List

| Column    | Description                    |
| --------- | ------------------------------ |
| Date Time | Time when the rule was created |
| Type      | Rule type                      |
| IP        | Blocked IP value               |
| Action    | Edit or remove the rule        |

### Remove All

Use Remove All only when you want to clear all blacklist IP entries for the account.

This can immediately change how your services handle traffic, so review the list before clearing it.

### Best Practices

* Prefer specific IP rules when possible.
* Use wildcard or range rules carefully because they can block large networks.
* Add trusted traffic to Whitelist IP Address instead of removing important blacklist entries.
* Test traffic after adding a new rule.

### Related Pages

| Page                                                                                           | Purpose                                    |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [Whitelist IP Address](https://docs.stopbot.net/v2/panel-guides/settings/whitelist/ip-address) | Allow trusted IP addresses                 |
| [Blocker](https://docs.stopbot.net/v2/panel-guides/services/blocker)                           | Review how Blocker handles visitor traffic |
| [Blocker V2](https://docs.stopbot.net/v2/panel-guides/services/blocker-v2)                     | Review advanced traffic filtering          |
