> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openrevenue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation security

> Configure allowed hostnames, blocked IPs, blocked pages, and masked pages for safer OpenRevenue tracking.

## Allowed hostnames

Your project domain and its subdomains are always accepted. Use allowed hostnames to also accept events from extra hosts (preview URLs, alternate domains). Unlisted foreign hosts are still rejected.

```text examples theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
preview.vercel.app
staging.myapp.com
*.mypreview.app
```

| Name | Type | Description |
| - | - | - |
| `preview.vercel.app` | hostname | Allow exactly that host in addition to your project domain. |
| `staging.myapp.com` | hostname | Allow one specific extra host. |
| `*.mypreview.app` | wildcard | Allow that apex and all of its subdomains. |

> [!NOTE]
>
> Manage allowed hostnames from `Project settings → Security`. Your project domain always stays allowed.

## Blocked IPs

Use blocked IPs to exclude internal traffic, QA devices, office networks, or noisy monitors from your reports. Enter an exact address or a CIDR range, IPv4 or IPv6. Use the public IP your network exposes: private addresses such as `192.168.x.x` or `10.x.x.x` never reach OpenRevenue.

```text examples theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
203.0.113.10
198.51.100.0/24
```

## Blocked pages

Blocked pages prevent specific paths from being tracked. This is useful for admin areas, previews, or routes that should not appear in analytics. A trailing `/*` covers every path below it but not the path itself, so add both `/admin` and `/admin/*` to block a whole area. An inner `*` or a `:name` placeholder matches one path segment.

```text examples theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
/admin
/dashboard/*
/preview/*
```

## Masked pages

Masked pages group dynamic paths into readable patterns so reports do not fill up with unique IDs.

```text examples theme={"theme":{"light":"one-light","dark":"one-dark-pro"}}
/orders/*
/users/*
/projects/*/settings
```

> [!TIP]
>
> Masking keeps pages like `/orders/123` and `/orders/456` grouped as one report row.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.