> 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/hostname.md).

# Hostname

Whitelist hostname rules are useful when a trusted service is repeatedly matched by other filtering rules but should still be allowed.

### Marked Screenshot

<figure><img src="/files/QMRhsWj87esBA1bl73Tj" 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      | Guide         | Open the related service guide.                     |
| 4      | Hostname Type | Select exact hostname or wildcard hostname type.    |
| 5      | Hostname      | Enter the hostname value.                           |
| 6      | Add Hostname  | Add the hostname rule to the list.                  |
| 7      | Remove All    | Remove all records in this list after confirmation. |

### Add Whitelist Hostname

The Add Whitelist Hostname form includes:

| Field    | Description                                   |
| -------- | --------------------------------------------- |
| Type     | Hostname rule type                            |
| Hostname | Trusted hostname or wildcard hostname pattern |

### Supported Types And Examples

| Type     | Single Example        | Bulk Example                              | Use It For                                             |
| -------- | --------------------- | ----------------------------------------- | ------------------------------------------------------ |
| SINGLE   | `trusted.example.com` | `trusted.example.com,monitor.example.net` | Allowing exact trusted hostnames                       |
| WILDCARD | `*.example.com`       | `*.example.com,*.example.net`             | Allowing every hostname under a trusted domain pattern |

The panel supports comma-separated multi-entry input for adding multiple hostnames at once.

### Example Scenarios

| Scenario                                    | Type     | Value Example                             |
| ------------------------------------------- | -------- | ----------------------------------------- |
| Allow one exact trusted hostname            | SINGLE   | `trusted.example.com`                     |
| Allow two exact trusted hostnames at once   | SINGLE   | `trusted.example.com,monitor.example.net` |
| Allow all subdomains from a trusted pattern | WILDCARD | `*.example.com`                           |
| Allow multiple wildcard hostname patterns   | WILDCARD | `*.example.com,*.example.net`             |

### How To Add

1. Open Settings > Whitelist > Hostname.
2. Choose SINGLE or WILDCARD.
3. Enter the trusted hostname value.
4. Click Add.
5. Confirm the entry appears in the Whitelist Hostname List.

### Whitelist Hostname List

| Column    | Description                    |
| --------- | ------------------------------ |
| Date Time | Time when the rule was created |
| Type      | Rule type                      |
| Hostname  | Allowed hostname value         |
| Action    | Edit or remove the rule        |

### Important Notes

* Hostname allow rules depend on hostname data available for the visitor IP.
* Wildcard hostname entries can match many hosts.
* Only whitelist hostnames that you trust.
* Review whitelist entries regularly to avoid keeping old exceptions.

### Related Pages

| Page                                                                                       | Purpose                                    |
| ------------------------------------------------------------------------------------------ | ------------------------------------------ |
| [Blacklist Hostname](https://docs.stopbot.net/v2/panel-guides/settings/blacklist/hostname) | Block unwanted hostnames                   |
| [Blocker](https://docs.stopbot.net/v2/panel-guides/services/blocker)                       | Review hostname decisions                  |
| [Blocker V2](https://docs.stopbot.net/v2/panel-guides/services/blocker-v2)                 | Use advanced filtering with hostname rules |